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This publication provides programmers and systems analysts with 
a description of the functions performed by the ibm 1410/7010 
Operating System Utility Programs and the requirements for 
their use. These programs permit the user to obtain printed list- 
ings of all or part of core storage, magnetic tape storage, and ibm 
1301 and 2302 Disk Storage. The programs also provide disk 
address and format generation, data file generation, and the 
capability to save and restore data files. 

The reader of this publication should be familiar with the con- 
cepts and use of the System Monitor. This information is included 
in the publication IBM 1410/7010 Operating System; System 
Monitor, Form C28-0319. 

Note: The ibm 1302 Disk Storage Unit is now designated the 
ibm 2302 Disk Storage Unit; there has been no change in the unit 
itself, in the applications for which the unit may be used, or in 
the programming parameters used to specify those applications. 
The ibm 2302 Disk Storage Unit designation has been used in 
the text of this publication; programming parameters remain 
unchanged and refer to 1302. 
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that publication and its associated Technical Newsletter 
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changes are indicated by a bullet (•) at the left of the figure 
caption. 
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Introduction 



This publication provides programmers and systems 
analysts with the information needed for using the ibm 
1410/7010 Operating System Utility Programs. These 
utility programs create listings of core storage and tape 
and disk files, generate formats and addresses for disk 
storage, perform file save and restore operations, and 
generate data files. 
The utility programs provided are: 

Snapshot 

Storage Print 

Tape Print 

Disk Print 

IBM 1301 Format/ Address Generator 

IBM 2302 Format/Address Generator 

File Save 

File Restore 

Data File Generator 
Note: Three utility programs for ibm 1311 Disk 
Drives are also available to the Operating System user. 
These programs are: (1) ibm 1311 Disk Format/ 
Address Generator, (2) ibm 1311 Disk Label Program 
and (3) the Disk Print program (listed above), which 



is used to print the contents of ibm 1311 Disk Storage 
Drives. Descriptions of 1311 Format/Address Gener- 
ator and 1311 Disk Label Programs, and a discussion 
of use of the Disk Print program for ibm 1311 Disk 
Drives, are contained in the publication IBM 1410/ 
7010 Operating System; Support of IBM 1311 Disk 
Storage Drives Under the Operating System, Form 
C28-0402. 

Prerequisite Publications 

The reader of this publication should be familiar with 
the information contained in the following publications: 

IBM 1410/7010 Operating System; Basic Concepts, 
Form C28-0318. 

IBM 1410/7010 Operating System; System Monitor, 
Form C28-0319. 

Minimum Machine Requirements 

The minimum machine requirements for using these 
utility programs are specified in the publication IBM 
1410/7010 Operating System; System Generation, 
Form C28-0352. 
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Control of the Utility Programs 



The operation of all utility programs except Snapshot 
is controlled by special utility control routines, which 
are brought into core storage by a mon$$ exeq utilities 
card (see Figure 1). In addition there is at least one 
Utility control card for each utility program. Some 
utility programs require additional cards. The control 
routines ( 1 ) read the Utility control card that follows 
the Monitor card, (2) bring the appropriate Utility 
program into core storage, and (3) provide the routine 
with information from parameters entered on the 
Utility control card. After each Utility program has 
been executed, the control routines check for other 
Utility control cards; thus several Utility programs can 
be executed by using one mon$$ exeq utilities control 
card and several Utility control cards. 
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Figure 1. Monitor exeq Utilities Card 



The Utility control cards and the programs to which 
they refer are as follows: 



CARD 

DUMP 

FORM 

SAVE 

RESTO 

FILGN 



PROGRAM 

Print programs 

Format/ Address Generator programs 

File Save program 

File Restore program 

Data File Generator program 



A blank in any column from 21 to the end of the 
control card signifies the end of the control parameters 
for that card; no columns beyond the blank are 
scanned. 

The ibm 1301 and 2302 Format/ Address Generators 
and Data File Generator program use additional con- 
trol cards. The ibm 1301 and 2302 Format/ Address 
Generators require ha2 and rec control cards. The 
Data File Generator program requires file-specification 
control cards. In addition to the control cards, the Data 
File Generator program requires input data cards. 

The File Save program may require additional con- 
trol cards: if the disk surface type of save is used and 
more than one surface is to be saved, one control card 
is required for each additional saved surface. 



Utility Control Card Errors 

Two types of errors can occur when the Utility control 
cards are used: errors in parameter specification, and 
control card read errors. 

Parameter-Specification Errors 

The following messages may be issued on the spr as a 
result of Utility control-card parameter errors. The 
entire contents of the card in error are printed. If the 
card in error is a form or save card, the Utility control 
routines also issue a 10401 console message and set a 
special end-of -program condition in Resident Monitor. 

INVALID FIRST PARAMETER 

. . . (control card in error) . . . **uterr** 
There is an error in the first parameter. 

invalid parameter ( parameter creating error ) 
. . . (control card in error) . . . **uterr** 

There is an error in a parameter other than the first. 

missing parameter 

. . . (control card in error) . . . **uterr** 

One ( or more ) of the required parameters has been 
omitted. 

Read Errors 

If the siu is a card reader and a read error occurs, the 
reader stops and an iocs error message appears on the 
console typewriter. If the siu is a magnetic tape unit 
and a read error occurs, the course of action followed 
by the Utility control routines depends on the type of 
Utility card-image read, as follows: 

1. If the Utility control card with a read error is a 
filgn card, control is given to the Data File Generator 
program, which reads the next card. In this case, be- 
cause filgn is the only entry on the card used by the 
program, the file generation control routine ignores 
any errors except in filgn. See item 3 for action taken 
if a read error occurs in the filgn entry. 

2. If the Utility control card with the read error is 
a form, save, or resto card, the following occurs: (a) 
the Utility control routines print the following message 
on the spr: 

READ ERROR ON SIU 

. . . (control card in error) . . . **uterr** 

and (b) the program issues a 10401 console message 

and sets a special end-of -program condition in Resident 

Monitor. 



3. If the Utility control card with a read error is a 
dump card, or if the card cannot be identified, the pro- 
gram issues the read error on siu message, as de- 
scribed in item 2. The contents of the control card in 
error are printed. The control routines then read and 
analyze a new card. 



Control of the Utility Programs 7 



Print Programs 



A printed listing of all or part of core storage or mag- 
netic tape or disk storage may be helpful when testing 
a program. The utility programs that make these list- 
ings available are Snapshot, Storage Print, Tape Print, 
and Disk Print. If the user's spr is a magnetic tape file, 
the listings can be printed on an ibm 1401 System by 
means of the pow program ( see the publication IBM 
1410/7010 Operating System; Operators Guide, Form 
C28-0351). 

The Snapshot program provides listings of core stor- 
age during the program run; if Snapshot is specified at 
System Generation, the utility program also provides 
a core storage listing at Unusual End of Program. The 
programmer specifies how much of core storage is to 
be printed and the points in his program at which 
Snapshot listings should be provided. 

The Tape Print and Disk Print programs can be used 
before or after any program run. 

The Storage Print can be used only after entry to 
Unusual End of Program. If Storage Print is to be 
executed within the same job as the program to be 
printed, that program must be run in test mode. A 
production program can be run in test mode at any 
time. 

Listings 

The output of the print programs is on the spr, which 
can be either an ibm 1403 Printer or an ibm 729 or 
ibm 7330 Magnetic Tape Unit. The pow program can 
be used to print the tape. 

All of the print programs use the same format for 
their listings: 100 characters per line, in 10 groups of 
10 characters, for each line of data. Two print lines are 
normally used for each line of information. This for- 
mat permits word marks and other identifying charac- 
ters to be printed over the appropriate character. The 
status indicator settings, parity, and index registers are 
printed when applicable. 

Because there is a limit to the number of different 
characters that can be put on any one print chain, cer- 
tain valid characters cannot be printed. Substitute 
characters are provided for these and are identified as 
such on the listing. The following substitution table 
applies to all print chains. 

A substitute character is identified by an "I" over the 
character. Word marks for standard characters are 
designated by a "V" over the position of the character. 
A substitute character with a word mark is identified 



by a "Y" which may be thought of as a combination 
of the "I" and "V" indications. 



UNPRINT- 




ABLE 


BCD 


SYMBOL 


CODE 


? 


CBA82 
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B82 
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CBA8421 




A8421 
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CA841 
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CA842 
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BA841 
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CB841 
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C8421 
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BA842 
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842 
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CB842 




841 
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B8421 



Question Mark ( plus zero ) 
Exclamation Point ( minus 

zero) 
Group Mark 
Segment Mark 
Word Separator 
Backslash 
Substitute Blank 
Left Bracket 
Right Bracket 
Tape Mark 
Less Than 
Greater Than 
Semicolon 
Colon 
Delta 



TUTE 

+ or & 



H 
W 

/ 
blank 
L 
R 
T 
S 
G 



D 



Control of Print Programs 

All print programs except Snapshot are individual 
phases of a multiphase program, requiring only one 
control card (dump) in addition to the mon$$ exeq 
utilities card. The Snapshot program is under control 
of a Linkage Loader snap control card, System Gener- 
ation card, or Autocoder calling sequence rather than 
a Monitor control card. 

All of the utility print programs except Snapshot 
require that the control routines be brought into core 
storage by the mon$$ exeq utilities card ( see "Control 
of the Utility Programs" ) . 

The operator can interrupt any of the Utility print 
programs, except Snapshot, and return to the control 
routine by the following procedure: 

1. Press Inquiry Request key 

2. Enter $3x ( x can be any character except a blank ) 

3. Press Inquiry Release key 

The generation of the listing stops, and the message 

CONSOLE INTERRUPT, PROGRAM TERMINATED is printed. 

The control routine then reads and examines the next 
card in the siu. 



Snapshot 

Snapshot can be used to print all or parts of core 
storage during the program run. Snapshot is a re- 
locatable subroutine u.°ed primarily for testing pro- 
grams. All of core storage may be "snapped," if desired. 



Snapshot also prints the location of the next instruction 
to be executed ( identified by the prefix "m" ) and four 
of the status indicators (high, low, equal and zero 
balance ) . 

The programmer can use one of two methods to 
obtain a Snapshot: a snap card or an Autocoder calling 
sequence. A mon$$ exeq utilities control card is 
not used. 

Snapshot can be incorporated as part of Resident 
Monitor (see System Monitor publication). 

Index registers 1-4 and 13, which are used by the 
Snapshot program, are saved and restored. The same 
is true for settings of the compare indicators, overflow 
indicators, and zero balance indicator. 

SNAP Card 

snap cards direct the Linkage Loader to create patches 
in the user's program. Each card defines one or two 
areas to be printed at a given point in the user's pro- 
gram. If more than two areas are desired, additional 
snap cards can be used. For details of the snap card, 
see the System Monitor publication. 

Autocoder Calling Sequence 

The Autocoder calling sequence provides the same 
calling sequence as the snap card. If used, it must be 
coded into the source programs by the programmer. 
Like the snap card, each Autocoder calling sequence 
can designate one or two areas to be printed. If more 
than two areas are desired, the end of the execution 
of Snapshot may lead to another calling sequence in- 
stead of returning to the dependent program. The 
calling sequence that must be used to execute Snap- 
shot is indicated in Figure 2 (except for the operand 
"snapshot" in line 1, the operands and comments used 
are examples). 



DCW 
BU 



@ N00000 

NSINS 



Operation 


Operand 


Comments 


DCWS 


SNAPSHOT 


Branch to Snapshot 


DCW 


@NOO0OOO00OOOO@ 


May be used to fnsert instroction(s) 


B 


EXIT! 


Branch to program or another Snap 


DCW 


@30497@ 


First start address 


DCW 


@31984@ 


First stop address 


DCW 


+START 


Second start address 


DCW 


+EXIT3 


Second stop address 


DCW 


@PROG8@ 


Identification 



Figure 2. Snapshot Calling Sequence Example 

The first line appears as shown in the example in 
Figure 2 unless Snapshot has been included in Resi- 
dent Monitor. ( If Snapshot is in Resident Monitor, the 
first line of the sequence should be b /snp/ rather than 
dcws snapshot. ) The second line of the sequence may 
be used by the programmer for the instruction or in- 
structions displaced by the patch that branches to the 
Snapshot program. For example, the user might follow 
the dcws snapshot with: 



The instructions (or nop) that are inserted between 
the first and third lines of the calling sequence must 
occupy exactly 13 positions of core storage. In the 
above example, six characters are generated by the 
dcw and seven characters by the Branch Unequal 
coding — a total of 13. 

Contrary to the usual calling sequence, when the 
Snapshot is completed, it branches to the position 
following instruction: 



DCWS 



SNAPSHOT 



The b exit instruction can branch to another Snap- 
shot sequence or to the user's source program. The 
start and stop address may be either actual addresses 
or address constants. In the example, the printed listing 
will include the contents of the area from 30497 to 
31984 and the area defined by + start and +exit3. If 
only one area is to be printed, the second start and stop 
addresses must contain blanks. 

The last dcw, which must be five characters, is the 
programmer's identification of the point in the pro- 
gram at which the Snapshot occurs. It will be printed 
just as it appears in the calling sequence. 

Snapshot Listing 

Figure 3 is an example of a Snapshot listing. 

The first line of each Snap listing requested contains 
the Snapshot identity specified in the Autocoder se- 
quence or the snap card, the location of the next in- 
struction to be executed (ra), the status indicator 
settings, the date, and the requested start and stop 
addresses for the Snapshot. If the programmer has 
specified the start address higher than the stop, the 
Snapshot program will exchange the two addresses 
before preparing the printout. Asterisks identify the 
indicators that are on. 

The next line (line 00000) shows the contents of 
the first hundred positions of core storage; the user 
can refer to this line for the contents of the index 
registers. The contents of the specified areas of core 
storage follow. The program prints the storage areas 
from the first hundreds position at or before the 
specified start address ( absolute ) to the next 99's posi- 
tion at or above the stop address. Print lines from com- 
pletely blank storage areas are omitted from the listing. 



Storage Print Program 

The Storage Print program prints the contents of 
specified areas of core storage, the contents of the 
Instruction Address Register, the settings of four of 
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SNAPS 
00000 
22800 


IR 18090 li 
V V 
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V V 
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HI EQ 
V 
F000056RXO 

V 
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• LO AV OV 
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Figure 3. Example of Snapshot Listing 



the status indicators (high, low, equal, and zero bal- 
ance), and the contents of the index registers. This 
print program can be used only on those systems that 
have a Core Image file option specified. 

The Storage Print listing is obtained from the Core 
Image file. Records are written on this file only when 
a program reaches /uep/. The program to be printed 
must be run in test mode if a Storage Print is to be 
executed within the job. 

Three records are written on the Core Image file 
each time entry is made to /uep/ : 

1. All of core storage 

2. The dependent-program area of core storage 

3. An area beginning at a point ( defined by the con- 
tents of /ogr/) within the dependent area and 
extending to the end of core storage 

These three records are referred to collectively as 
one storage write. The last record should be at least 
the size of the Storage Print program, which is ap- 
proximately 8,000 characters, including the Utility con- 
trol routine. See "Extended iocs Macro-Instructions, 
ioctl chkpt" in the publication IBM 1410/7010 Oper- 
ating System; Basic Input/Output Control System, 
Form C28-0322, for details of /ogr/. 



Storage Print Control Card 

Each Storage Print (dump) control card specifies one 
area to be printed. If the Core Image file currently in 
use is the one to be listed, the control card has the 
format shown in Figure 4. 



all Print all storage writes residing on 
the Core Image file. No start or stop ad- 
dresses are accepted. 

last Print an area of the last storage 
write recorded on the Core Image file. The 
area is specified by the start and stop 
addresses. 

name Print the defined areas of all stor- 
age writes of the program identified by this 
"name." "name" is the dependent program 
as defined on the exeq card for that pro- 
gram. All programs called "name" on the 
Core Image file are printed. 
The start and stop parameters are the limits of the 
area to be printed. They can be any of the following: 

1. Absolute addresses calculated from the listings 
produced by a compiler and the Linkage Loader. 

2. The beginning of the dependent program area 
(specified by /org/), the end of the last batch 
program (specified by /siz/), and the end of core 
storage minus 2 (specified by /ams/). 

3. Any number of positions in either direction from 
these reference points. The parameter is specified 
by nine characters, i.e., the reference point, a 
sign, and a five-digit number, such as org + 00078. 
If start or stop is omitted all of core storage is 
printed. 

If the Core Image file was prepared previously, or 
on another system, it must be mounted on a tape unit 
that is assigned to mwo. In this case the dump control 
card has one of the formats shown in Figure 5. 
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Figure 4. Control Card Format, Storage Print from Current 
Core Image File 
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Figure 5. Control Card Format, Storage Print from Previous 
Core Image File 



core Specifies the Storage Print program. 
mdm The current Core Image file is to be printed, 
xxxxx The parameter shown as xxxxx in Figure 4 
is one of three possible entries: 



Parameters in the control card for the case of a 
previously recorded Core Image file are the same as 
for the current Core Image file control card, with 
three exceptions: 
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1. The tape is specified as mwo. 

2. The "last" option is not available. 

3. There is an additional optional parameter, U, 
that causes the mwo to unload when the storage 
print is complete. 

The mwo is always rewound after the storage print 
is processed. 

Note: In all Storage Print control cards, omitted 
parameters do not have to be indicated by commas. 

Storage Print Listing 

The format of the Storage Print listing (see Figure 6) 
is similar to that of Snapshot. On the first line are 
printed the program name and number of the phase 
(if the dependent program is a multiphase program), 
the contents of the Instruction Address Register, set- 
tings of status indicators, the date of the run as it 
appears in /dat/, the date of the storage listing, and 
the start and stop addresses. On the second line are 
printed pertinent system symbols and their absolute 
address equivalents. The symbols are the following: 
/mid/, /phn/, /ams/, /tpb/, /org/, /dat/, /cpt/, 
/siz/, /ogr/. The contents of the first 100 storage posi- 
tions (including the index registers) are printed on 



the third line. The following lines display the contents 
of the specified area of core storage. 

The program prints the storage areas from the hun- 
dreds position at, or immediately before, the specified 
start address ( absolute ) to the next 99's position at, or 
above, the stop address. 

If the start and stop addresses are specified incor- 
rectly, reversed, or omitted, all of core storage is 
printed. 

When the control card is punched as the example 
in Figure 7, positions 01700 to 78999 on an 80,000- 
character system will be printed. (The first and last 
lines are always printed in their entirety.) The last 
storage write on the Core Image file is the one printed. 

It might not be possible to print a complete storage 
write. This may occur when the storage write is 
printed by a system smaller than the one on which 
it was made, or when it is printed on a system with 
a dependent area shorter than about 16,000 positions. 
If it is not possible to print all of the requested area, 
the partial lines of the area are filled with asterisks, 
and the message this portion not available appears 
between the lines. Figure 8 is an example of such a 
printout. 



CORE DUMP UTPRINT 001 IR 30138 


ZE • HI • 


EQ LO 


DATE 64268 


64266 START 00000 


STOP 02300 




SYSTEM SYMBOLS 24634MID17561PHN 1760 IPNM 17571 AMS17581TPB175860RG17566DAT14628CPT17591SIZ175860RG 
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000 M'F014 




V 


Y 


V 


IV 


VV 


II V 


V 


V 


VV 


YV 


01200 


794WD14803 


OOOOOL+005 


1700089R04 


256+D00315 


000002 V000 


♦+601294LM 


•F001288WJ 


01204 SOU 


1814796JR 


HAMELOOOtD 






VVVVY II 


V 


I V 


I 


Y 


V 


VV V 


V 


V 


01300 


0372701325 


100DD+00+- 


0000000022 


7300+/5200 


579500+K30 


+005170008 


9)01727037 


04JB15416G 


00099AT052 


52991 I44G0 




Y II 


V I 


V 


V 


Y II 


V I 


I V V 


VVVVVVVVV 


V 


Y II V 


01400 


0099B+00++ 


100094D00+ 


J501437TM' 


FXOO0OORG1 


44948*00++ 


108641,00+ 


+2G01550B0 


DDDNNNNNJ0 


14921R0138 


62+00++1A0 




V 


V 


II V 


II 


Y II 


V 


V 


VVVVV 


Y II 


V 


01500 


149814662J 


02218 W01.6 


3000+-72WO 


158500+-7- 


♦00+-00000 


0V03625037 


0*10015500 


372710D0DV 


01726+00+- 


015453V036 




V 




VVVVV 


V II 


Y II 


V 


V 


VVV 


VV Y 


II V 


01600 


25037041D0 


1595037271 


D0D0V01726 


♦0168700*- 


74+00+-000 


000V0 36250 


37041D0164 


0037271DD0 


DV01726+00 


♦-000000V0 






V 


VVVVV 


V V 


V 


V 




V 


V 


Y 


01700 


3625037041 


0016970372 


7100DDB144 


76G03733AJ 


03804 V022 


9901437KB0 


2299014313 


W018210143 


11B0182101 


4312+01436 




V I 


II VVV 


VV 


V 


V 


V 


V 


V 


V 


V 


01800 


00099000+A 


600++63DDD 


0D01832014 


313D014370 


2206XV0218 


5V02820024 


93KB028200 


2487300188 


6024873D02 


49302738XV 




V 


V 


V 




V 


V V 




V 


V 


V 


01900 


02717V0356 


003414KB03 


560034083D 


0192803408 


3003414033 


17XV03294V 


0319003044 


KB03190030 


383D019820 


3038300304 




V 


V 


Y 


V V 


II V 


V 


V V 


V I 


I V I 


V 


02000 


402947XV02 


926Y013731S 


+086360009 


4J02325V+0 


0+-008636J 


020&3VJ020 


76 B08636G 


08604AS00+ 


-0D00+J502 


206XV02185 




V I 


V IV 


V 


V 


IV 


II V 


II V 


II V 


V 


VV 


02100 


DOO+J00211 


6PNF1N-RQ2 


11.22)02113 


02U5R0439 


7+D0021300 


♦-0XV00187 


00+-11B165 


1100+-72YI 


5564XA0218 


514662NM<2 




Y 


V 


I 


V V 


V 


Y 


V 


V I 


V IV 


I V 


02200 


023135W+00 


0940864100 


0+J9022793 


J023251R02 


2511R02197 


2+08641000 


94A00 18714 


662R04269+ 


R02287+W01 


74600+K52H 




I 


VV V 


V 


V V 


V 


V 


V 


V V 


II V 


V V 


02300 


0382900+K4 


2DW07836J0 


3579 J0284 


62Y027722Y 


02346F.146 


63T0586315 


4531V02565 


G00099BBOO 


♦+2G00595A 


G01595AYO0 


END OF CORE 


DUMP. 




















HON** 


END 





















Figure 6. Example of Storage Print Listing 
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Line 
3 5 


Label 

6 


IS 


Operation 

16 20 


OPERAND 

21 25 30 35 40 45 90 


55 


60 


65 


70 


0,2 




DUMP. 


C 0A£,,MPM, I A.ST^OJ .7.0.3,, t AM£r A* P.0,0, . , 


1 
• i . t 1 i • i 


, , , . 


i..J.J 1..J. J.J- 1 1 L_L-.J._L_l..i. . .1-1.-1 1....1 1. 1 . 1 1 1 1 | | | | 


iiit 


..iii 


i i i i 





Figure 7. Example of Storage Print Control Card 



91100 
51200 
51300 

90000 
90100 
90200 



Y V V V V 

1-00100J0? 173 E99IZ1 J06178VA06 

W v Y V 

5#DG06221A G06836AG00 09900089J0 9120 £0591 

WW V V I 

98 0AO0100 BC00O89000 99J09120 W 1623900£/3 

THIS PORTION NOT AVAILABLE 
V V IV vv 

15973 Y091 46X8051540 0C/6BJ0919 8 CJ07173 

V V IV V 

41809914CJ 06498 V161 6300GA3SY0 9146XW0658 
I V V IV V II 



16499I2U0 6190VJ0632 
V 



V VI V V V 

2 80632209 881RD00G/0 06207/Y135 10EG06221B 0235740009 

V Y V V V V 

309881W065 42001004WO 6755001008 £011960988 |»06467J06 761 NSJ091 

V V 

1Y09146XJ0 6418...... ••»••••••• .......... •••••.•••. .......... 

VVVI VV V VV 

NJ06819 f 6467000CS3 06497AM000 0000992309 91BTJ09021 20101 B06 

IV W V I V V I V I Y 

700G/64U09 198 BS99IY 9W0660500& /67S99IY30 0661600G/5 *S00CT3C00 

V VV V VV IVV 

C+000094J0 6819V00010 000CK30006 616&00C-00 0094J06684 VJ06641 Jl 5973 Y0914 6X,08780B0 717300G/64 Q08780V067 



Figure 8. Example of Partial Printout 



Entry to /uep/ can be made in three ways: (1) by 
error branch or coded branch to uep, ( 2 ) by the Con- 
sole Inquiry message $10, (3) or by computer reset 
and start (rst). Because of the varied entry to /uep/, 
the contents of the registers and indicators, as printed, 
are not always valid. The contents of the index regis- 
ters, the high, low, equal, and zero balance indicators 
(H, L, E, and Z), and the contents of the Instruction 
Address Register (iar) are printed. Figure 9 shows 
which registers or indicators contain valid information 
under each of the three above conditions. 





IAR 


H,L,E&Z 


X1-X12 


X13 


X14-X15 


UEP 
$10 
RST 


YES 
YES 
YES* 


No 
Yes 
Yes 


Yes 
Yes 
Yes 


Yes 
Yes 
Yes 


Yes 
No 
Yes 



* This will always be 00008 

Figure 9. Valid Indicators and Registers 

Storage Print Messages 

The following messages may appear in the listing on 
the spr: 

RCD 1 MAY HAVE ERR IN AREA — ORG. 
RCD 2 MAY HAVE ERR IN AREA ORG — OGR. 
RCD 3 MAY HAVE ERR IN AREA OGR — AMS. 

The above messages occur if a data check is detected 
in reading the indicated record. 

PROGRAM REQUESTED NOT ON TAPE. 

The name of the program to be printed was not 
found on the specific tape. 

LAST TAPE RECORD NOT A CORE DUMP. 

No storage print entry is present on the portion of 
the Core Image file specified on the control card. 



THIS PORTION NOT AVAILABLE. 

This message appears if the area available in core 
storage is not large enough to read in all of the 
specified dump (see "Storage Listing"). 

WORK AREA TOO SMALL TO OBTAIN STORAGE PRINT. 

There is not enough room in the dependent program 
area to contain both the Storage Print program and 
the smallest tape record that can be used by it. The 
size of that record is equal to the largest value in 
the table of system symbol values to be printed in 
the second line of the storage listing, with the ex- 
ception of /mid/ and /tpb/. 

UNIT NAMED NOT MDM OR MWO. 

This message is self-explanatory. 

CONSOLE INTERRUPT, PROGRAM TERMINATED. 

The processing of the print program has been inter- 
rupted by a $3x message from the console. 

END OF CORE DUMP. 

The Storage Print processing has been completed. 

Tape Print Program 

The Tape Print program prints the contents of any 
reel of tape as specified on the control card. If more 
than one tape physical unit is assigned to the specified 
symbolic unit, the tape reel printed is the one on the 
last physical unit used for that symbolic unit. Output 
is placed on the physical unit assigned to the spr. 

The Tape Print program, including the Utility con- 
trol routine, requires approximately 7,000 positions of 
core storage. If a tape record to be printed is larger 
than available core storage, as much as possible of 
the specified tape record(s) will be printed. The 
Asterisk-Insert switch must always be on. 

The tape can be read in Move mode or in Load 
mode. Printing can start at one of the following points: 
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1. Load point 

2. A specified number of tape records or files from 
load point 

3. The current tape record 

4. A specified number of tape records in either direc- 
tion from the current record 

5. A specified number of file records forward from 
the current record 

A tape-mark record is any record whose first char- 
acter is a tape mark. For the Tape Print program all 
tape-mark records are counted and treated as tape 
records, whichever direction the tape is moved. 

Printing will stop at one of the following points: 

1. End of the last specified record or file 

2. Standard end-of-reel trailer ( ieor ) 

3. Special trailer ( lEOTbTAPEDUMP ) 

Tape Print Control Card 

The format of the Tape Print (dump) control card is 
shown in Figure 10. 

The first operand must be tape; the other operands 
can appear in any order. 

The operands have the following meanings: 



TAPE 
Mxy 

mode 
TLR 



RWD 



± pxxxxx 



This entry specifies the Tape Print program. 
This entry specifies the symbolic unit from 
which data will be printed, (x must be R, T, or 
W; y is the specific unit. ) 

(Optional) LOAD or MOVE. If this entry is 
omitted, Load mode is assumed. 
(Optional) This entry causes immediate writing 
of the special trailer label lEOTbTAPEDUMP on 
the tape. The tape is then rewound. The pro- 
gram next moves the tape forward as specified 
in the ± pxxxxx parameter and prints the tape 
records following. The print processing stops 
when the special trailer label is encountered or 
the specified number of tape records or files are 
printed. If this option is specified and the user's 
program rewinds an output tape, the Tape Print 
program will write the trailer at the beginning 
of the tape and the tape will not be printed. 
(Optional) This entry causes rewinding of the 
tape, establishing load point at the starting 
position of the next operand. 
(Optional) This entry specifies the distance and 
direction the tape is to be moved before process- 



ing the printing. The first two characters can be 
+ T, +R, or -R. -T cannot be used. The sign 
indicates the direction, and the letter indicates 
whether tape-mark records (T) or data records 
(R) are to be counted. The value of xxxxx can 
be zero. If this entry is omitted, the parameter 
+ R00000 is assumed, leaving the tape in the 
same position, 
qyyyyy (Optional) The first character must be T or R. 
yyyyy specifies the number of tape-mark records 
( T ) or data records ( R ) that will be counted in 
processing the printing. The value of yyyyy can 
be zero. R00000 (no printing) used in conjunc- 
tion with ± pxxxxx is useful for positioning a 
tape. Omission of this operand has the effect of 
T99999. To space forward from the current 
record 25 files plus 1500 records, two cards can 
be used. The first would specify the last two 
operands as +T00025, R00000, and the second, 
+ R01500, R00004. Four records would be 
printed. 

A Tape Print specified as in Figure 11 prints the 
contents of the tape on unit mri specified on the con- 
trol card in Load mode. A special trailer record is first 
written on the tape and the tape is rewound ( note that 
the rwd entry is omitted). Then the tape is moved for- 
ward 24 records. Thirty-seven records are printed 
unless a standard or special trailer label or trailer 
record is encountered. 

Note: Omitted Tape Print parameters do not have 
to be represented by commas. 

Tape Print Listing 

The tape listing (see Figure 12) is similar to that of 
the other print programs. 

The first line of the tape print reproduces the con- 
trol card information. It is followed by a line with 
the column heading Record/Chars a statement of tape 
parity, and the tape-mark count. This line, with the 
current tape-mark count appears at the top of each 
page of the listing. 

The first line of each record printed contains the 
record number, followed by the number of characters 
in the record. The rest of the line contains the data 
in the first 100 positions of the specified tape record. 



Line 
3 5 


Label 
6 15 


Operation 
16 20 


OPERAND 

21 25 30 35 40 45 50 55 


80 


65 


70 


0.2 


i 
, . . , . 1 . , . 


DUMP, 


7APM,,Mx.</>,rn&d,e. f JM fi, ,/?##>.,, ■A/j.v.x.x-.x.*,,. 7, y.yy.y.y, . 








i 


. , , . 





Figure 10. Format of the Tape Print Control Card 



Line 



Label 



Operation 
20 



_J5_ 



_2S_ 



_3§_ 



JISl. 



OPERAND 
_45 SS_ 



_55_ 



-6§_ 



2, 



DUMP. 



TAP£. f A1 .1U i , l0AA i .T>L/Z,.+.&O.O.O. 24 .,.R> O.O.OA7 



Figure 11. Example of Tape Print Control Card 
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TAPE PRINT 


M«3 IN LOAD MODE «W0 


+R00002 R00001 














RECRO/CHARS 


000 


PARITY 


TAPE MARK COUNT 


















V V V 


V 


I V VV 


VV V 


V 


V 




VV VV 


V 


V V 


1 


2135 


213E02H010 


30PBOOL 00 


+P.-I060. . 


♦04G01040 


BCOL OOAO 


.-)004+-)l 


02*' >034+- 


)101'.. *0 


2F01050 BX 


PA 008. /PE 






V VV V 


V 


I V 


V V 


VV V 


V V 


V VV 


V 


V I V 


VV VV V 


101 




T/. *03GOI 


060 BOOL 


0+R.-1058* 


>004. )063. 


♦02E01070 


DCW OOB. 


1004. ♦02H 


0I080RQ0OL 


00+R,-)06 


3., *02E0l 






V 


V V V 


V V 


V I V 


VV VV 


V 


V V V 


VV V 


V I 


V VV VV 


201 




090PDCW 


0B.)002. * 


02H01100RB 


OOL 00 +P,- 


>058.. *02 


001110 OC 


OOB.'W. 


*02G0 1120 


PBOOL 00+P 


. )05S.. *0 






V 


V V 


V VV V 


V I 


V VV V 


V V 


V V 


V VV V 


V 


I V 


301 




2001130 DC 


OOB.'R' 


. *02G0114 


OPBOOL 00+ 


P.) 054.. * 


02E0IIS0 


CM 00B.)0 


05. *03BOI 


160PB00L 


0+P. 1052+) 






VV VV 


V 


V V V 


VV IV 


V V 




VV 


VV V 


V V 


V VV V 


401 




056.. *020 


01170 OCX 


OOB. 'J'. 


*04+01 180P 


BOOL OOAP. 


-• >052+)05 


4+10S6'.. 


102001190 


OCH 003.* 


•• *04C01 






V 


I V 




VV VV 


V 


V V 


V V 


VV V 


V I V 




«01 




200PBOOL 


0+P. )014») 


034»)036«- 


)osa.. *03 


C0I210 ZA 


OOC.) 004 


+23.)036. 


*04001220P 


BOOL 00+P. 


>004«-)034 








VV VV V 


V 


V 


V V VV 


V 


V V 




VV VV 


V 


601 




•>016»->05 


a.. *03Coi 


230 ZA 


OC. )004+23 


■)016. *04 


A01240PBOO 


L OOAP.) 05 


8+«-)004»- 


>058'.. *0 


3C01250 ZA 






V V 


V V 


VV V 


V I 


V 




VV VV V 




V I V 


VV VV 


701 




OOOOO 


2*23. >01F. 


*04001260 


PBOOL 00+P 


. )058*>111 


»-)052*-)0 


56.. *03C0 


1270 BOOL 


00+A. )013» 


->017.. *0 






V 


V V 


V 


V VV V 


V I 


V VV V 


V V 


V V 


V 


V VV V 


801 




3001280 ML 


CS 00O01 


8+ 15. /ERF/ 


. *02G0129 


BOOL 00+ 


a.)oi7,. * 


03C013A0AM 


LCS OOC. 4+ 


)01F./ERF/ 


. *02H0138 






V I 


V VV 


VV V 


V V 


V 


V VV V 


V 


V V 


V VV V 


V 


901 




BOOL 00* 


B.-)016.. 


*03B013C0 


ZA OOC.) 


002+23. X13 


. 403B013D 


MLCS OOC 


■4+X13./ER 


F/. *02A01 


3E0BMLCS 






VV VV V 




V VV VV 


V 


V VV VV 


V 


V VV VV 


V 


V VV V 


V V 


1001 




OB.. *02A0 


13F0 MLCS 


OOB.. *02A 


013G0 MLCS 


008.. *02 


A013H0 MLC 


S OOB.. *0 


2A013I0 C 


OOB.. * 


04H013J0 C 






V V 


V 




VV 


V 


V VV 




VV V 


V I 


V 


1101 




OOB./E 


OX/. LOOK 


FOR 1E0R 


R 1E0F *03 


O013K0 BBE 


OOB.. UN 


COO BRANCH 


*03D013L0 


PBOOL 00+Q 


.-)004+-)0 






VV VV V 




V VV VV 


V 


V IV 




V 


V VV V 


V 


V 


1201 




56.. *02A0 


13M0 MEND 


OOB.. *04G 


013N0QB00L 


00+. >058« 


-)016*)032 


•-)033.)07 


3. *05B013 


00 BOOL 00 


9P. )073»» ) 








V 


V VV V 




V V 


V V VV 


V 


V V 


V 


V VV V 


1301 




017+«-)017 


»-)013«'. ) 


073. *03B0 


1310 A 


OOC. )002+2 


3.»+6. *03 


E01320 ZA 


00O03S 


-1. )004+33 


. *03C0133 






V 


V V 


V VV V 




V V 




VV 


VV V 


V I 


V 


1401 




S OOC 


. >002+23.» 


-16. *04F0 


I340PBOOL 


00AP,-)058 


♦ • >058«)03 


2»-)033' .. 


*03I01350 


BOOL 00+0 


.-)017»-)0 






VV 


VV V 


V V 




V 


V VV V 




V V 






1501 




73*>013.. 


404E01360 


ZA OOC.) 


OI8+)020+) 


3E-1. )004 


♦33. *04H0 


1 370Q800L 


OOBQ.' )017 


+'->017»-) 


013' ■»)016 






VV VV IV 


V 


V 


V 


V VV V 


V 


I V 


VV VV I 


V 


V V 


1601 




.. *04+013 


80 ZA 00 


O03E-1 + ) 


016.)004+3 


3. *03C0I3 


900B0OL 00 


♦O.-)034») 


004.. *04+ 


01400 ZA 


OOC. )002+ 






V 


V VV 


V 


V V 


V 


V VV V 


V 


VV VV V 


V 


I V 


1701 




)01S-1.)00 


4 + 33, *03F 


014100A 


OOC. >004+ 


37.)004+33 


. *02A0I42 


C OOB 


.. *04E014 


30 BOOL 00 


+0. )036+)0 








V VV 


V 


V V 


V VV V 


V 


V 




VV 


VV V 


1801 




16»)101«-) 


034. »S *0 


2E01440 BH 


00B.O + 2 


6. *04G014 


50QB00L 00 


AQ.->036»» 


-)016+-) 10 


1 + ) 34 • . . 


*02£01460 






V V 


V VV V 




V V V 


VV V 


V V 


V VV 


V 


V V V 


VV V 


1901 




BH 00B.» 


+15. *02F0 


14700BXPA 


008. /PT4/. 


*02E01480 


DCM OOB. 


(004. *02D 


01490 OC 


OOB. 'V , 


*02G01S00 






V I V 


VV VV 


V 


V V V 


VV V 


V I 


V VV V 


V V 


V V 


V VV V 


2001 




BOOL 00+0. 

V 
40C800L 00 


)056.. *02 

I V 

♦0.) 10t»-> 


001510 DC* 

V 

036«->034. 


OOB.'J* . 
V 

• 8 * 


402H01520 


QBOOL 00+0 


.-)056.. * 


02001530 


CM OOB.* 


•. *04A01S 


2101 
















END OF 


TAPE 


PRINT 




















MONSS 


6N0 





















Figure 12. Tape Print Listing 



Each of the following lines is numbered to show the 
number of the first character on that line. 

Tape Print Messages 

The following messages may appear in the listing on 
the spr: 

SYMBOLIC UNIT NOT TAPE 

This message is given when a tape listing for a 
symbolic unit that is not a tape unit, such as a 1301 
disk unit, has been specified. 

SYMBOLIC TAPE UNIT NOT AVAILABLE 

A tape print of a symbolic unit that is not assigned 

or is not a work, reserve, or Tele-processing unit has 

been specified. 
tape mark ppppp qqqqq records since the last mark 

The listing has now reached tape mark ppppp. 

There were qqqqq records after the last tape mark. 
change parity 

The parity of the tape records changes at this point. 

NEXT RECORD HAS PARITY ERROR 

There is at least one parity error in the next tape 
record. The record is printed and the location of 
each error in the record is indicated by an asterisk. 

NEXT RECORD IS NOISE RECORD 

The next record printed is a noise record. It is less 
than 13 characters long and has a parity error. 



CONSOLE INTERRUPT. PROGRAM TERMINATED. 

The operator has entered a $3x message from the 
console. 

END OF TAPE PRINT 

The tape print has been completed. 



Disk Print Program 

The Disk Print program is similar to the other print 
programs. It prints the contents of any symbolic disk 
unit in the system. Records in disk storage are read in 
either Move or Load mode. If the records are in ibm 
1301 or 2302 Disk Storage, they can be read by either 
the Full Track with Home Address or Single Record 
operation. If the records are in ibm 1311 Disk Storage, 
they are read by the same type of operation used to 
write them. Complete details on the Disk Print pro- 
gram as used with ibm 1311 Disk Storage drives are 
found in the publication Support of IBM 1311 Disk 
Storage Drives Under the Operating System. 

The Disk Print program requires approximately 
11,000 positions of core storage; 5,000 positions for 
the program, including the utility control phase, and 
6,000 positions for temporary storage of data during 
processing. 
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Disk Print Control Card 

The Disk Print ( dump ) control card specifies one area 
of disk storage to be printed. The listings can start at 
the beginning of a symbolic unit or a specified number 
of tracks from that point. 

Figure 13 shows the format of the Disk Print ( dump ) 
control card. The type of disk unit (e.g., 1301) must 
be the first operand; the other operands can appear 
in any order. 

The entries have the following meanings: 

This entry specifies the type of disk unit, for 
example, 1301. 

The Mxy entry specifies the symbolic unit con- 
taining the records to be printed (x must be 
either R, T, or W; y is the specific unit). 
(Optional) The mode entry is either LOAD or 
MOVE. If the entry is omitted, Load mode is 
assumed. 



disk 
Mxy 

mode 

+ SSSSS 

ppppp 

Gzz 



This operand specifies the number of tracks or 
records to be spaced from the beginning of the 
symbolic unit before the print is begun. The 
sign must always be plus. Omission of this 
operand has the effect of +00000. 
The ppppp entry specifies the number of tracks 
to be printed. Omission of this operand has the 
effect of 99999. 

(Optional; required for Form C files) The G 
in this operand indicates that the file is a Form 
C file (sequential-geometric); zz must be two 
numeric characters, specifying the number of 
records on each track. The Read Single Record 
instruction is used by the utility program. 

A card punched as in Figure 14 requests a print of 
the 466th through 490th tracks of symbolic unit mr2. 
The tracks, recorded in Move mode, are read with the 
Read Single Record instruction. Each track contains 
two records. 

Note 1 : Omitted disk parameters do not have to be 
represented by commas. 

Note 2: A disk dump control card which does not 
specify the Gzz parameter will cause a full track to be 
dumped. The Gzz parameter can be used for Form C 
records and for Form G records, if the Form G record 
format conforms to the Form C record format. When 
using the Gzz parameter, less than a full track can be 



read. However, the dumps will always begin with the 
first record on the track. When using the Gzz param- 
eter the ppppp specifies the number of records to be 
printed rather than the number of tracks. 

Disk Listing 

The disk listing (see Figure 15) is similar to that of 
the other Utility print programs. 

The first line of the listing reproduces the informa- 
tion on the control card. The second line consists of 
the column heading Track/Chars, a statement of the 
mode (Move or Load), the page number, and the 
date as contained in /dat/. This line is repeated, with 
the correct mode and new page number, at the top 
of each page of the listing. The third line contains 
the track number, the number of characters in the 
record, and the address used to read the track. 

The listing of the contents of the records is in the 
same format as the other printed listings. Blanks are 
counted as characters, and the cumulative character 
count is indicated in the margin. 

Disk Print Messages 

The following messages may appear in the listing on 
the spr (messages containing 1302 refer to the 2302 
Disk Storage Unit ) : 

NEXT TRACK HAS PARITY ERROR 

There is at least one parity error in the next disk 
track. The contents of the track are processed and 
the location of each error in the record is indicated 
by an asterisk. 

CHANGE MODE 

The mode of the disk records changes at this point. 

SYMROLIC UNIT NOT 1301 

The programmer has specified a 1301 Disk Print for 
a symbolic unit that is not a 1301 unit. 

SYMBOLIC UNIT NOT 1302 

The programmer has specified a 2302 Disk Print for 
a symbolic unit that is not a 2302 unit. 
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Figure 13. Format of the Disk Print Control Card 
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Figure 14. Example of the Disk Print Control Card 
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Figure 15. Disk Print Listing 



SYMBOLIC 1301 UNIT NOT AVAILABLE 

A 1301 disk print of a symbolic unit that is not as- 
signed, or is not a work, reserve, or Tele-processing 
unit, has been specified. 

SYMBOLIC 1302 UNIT NOT AVAILABLE 

A 2302 disk print of a symbolic unit that is not as- 
signed, or is not a work, reserve, or Tele-processing 
unit, has been specified. 

CONSOLE INTERRUPT. PROGRAM TERMINATED 

The operator has entered a $3x message from the 
console. 



TRACK ADDRESS XX — XX NOT FOUND 

The track address encountered by the program does 
not correspond to the address given on the dump 
card. The program will read the next record on the 
file. 

END OF 1301 PRINT 

The 1301 print has been completed. 

END OF 1302 PRINT 

The 2302 print has been completed. 
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IBM 1301 and 2302 Disk Format/ Address 
Generators 

The ibm 1301 and 2302 Disk Format/Address Genera- 
tor programs provide the Operating System with 
format and address generation for ibm 1301 and 2302 
Disk Storage, respectively. Both functions (i.e., format- 
ting and address generation ) may be performed in the 
same run or separately, as desired. 

Like other utility programs (except Snapshot), the 
1301 and 2302 Disk Format/Address Generator pro- 
grams are individual phases of the multiphase Utility 
Programs package. In addition to the mon$$ exeq 
utilities card, the programs require a form card, and 
two or more other control cards following the form 
card. Both programs can be used to generate either 
standard or nonstandard record addresses. 

Standard Record Addresses 

For generation of standard record addresses, the user 
need provide only control card information. Each 
record address generated can consist of six or more 
characters. The first four characters constitute the track 
address, and the remainder, the RA2 portion of the 
record address. The program increments the first two 
characters of the RA2 field by one to give consecutive 
addresses. Control card formats for providing record 
address information are described under "Control 
Cards." 

Optional Nonstandard Record Addresses 

The Disk Format Address Generator programs can also 
be used to write nonstandard record addresses consist- 
ing of six or more characters, as specified by the user. 
In this case the user provides his own routine to gen- 
erate the addresses. The routine must be compiled and 
put in the library in place of ibaddresr before the util- 
ities program is executed. The user must ensure the 
validity of each address he generates. 

The record address can be six or more characters and 
can consist of any characters except commas. The user 
can, in his routine, increment the addresses in any way 
he chooses. 

The user's routine must observe the following restric- 
tions: 

1. The title of the routine must be ibaddresr 

2. Two linkage symbols must be defined: 
raxf/ defin labela 
raff/ defin labelb 



Labela is the symbolic address of the first instruction 
to be executed in the user's routine. That instruction 
must be: 

labela sbr exit +5 

where exit is the label of the last instruction executed 
by the routine. Labelb is the symbolic address of the 
low-order position of an area containing the generated 
record address. This area must be the same size as the 
record address to be generated. The user's routine must 
put a word mark in the high-order position of the gen- 
erated record address. Each time a record address is 
required the 1301 or 2302 Format/Address Generator 
program clears this area and branches to the user's 
routine. The user's routine generates the address and 
branches back to the Format/ Address Generator pro- 
gram, which writes the address on 1301 or 2302 Disk 
Storage. 

Index register 5 is available to the user for his rou- 
tine. 

Note: For nonstandard record addresses, the nstd 
parameter must be entered on the form card (see 
"Control Cards"). If the user specifies nstd on the 
form card, but fails to include his ibaddresr routine, 
the 1301 or 2302 Format/Address Generator program 
writes sequentially-numbered record addresses equal 
in length to the length specified in the rec card. For 
example, if the user specifies ra000000 on the rec card, 
but fails to include the ibaddresr routine, the program 
writes 000001, 000002, 000003, etc., as record addresses. 

Control Cards 

Each Format/Address Generator program requires 
three or more Utility control cards in the following 
order: form, ha2, and rec On all control cards, omit- 
ted parameters need not be represented by commas. 
Leading zeros may be omitted. 

FORM Card 

This card specifies information such as the type of unit, 
the symbolic unit, the mode, and the type of format 
operation. In addition, the user may include other 
parameters described below. The first operand must 
be 1301 or 1302 (referring to the 2302 Disk Storage 
Unit); other operands may appear in any order. One 
form card is necessary for each job. Figure 16 shows 
the format of this card. 

The entries that may appear in the form card are as 
follows: 
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Figure 16. Format of the form Card for the 1301 and 1302 Disk Format Address Generator Programs 



130w 



Mxy 



mode 



FMT 



zA 



WDC 



-f-nnnn 



NSTD 



HA2 Card 



This entry indicates the type of disk unit used 
and must occupy the first field, "w" can be 
either 1 or 2. 

The Mxy entry designates the symbolic unit to 
be operated upon. It can be any file assigned to 
1301 or 1302 Disk Storage. The file must be a 
work, Tele-processing or reserve file (i.e., x 
must be W, T, or R ) . 

(Optional) The mode entry is either LOAD or 
MOVE. If this parameter is omitted, Load mode 
is assumed. 

( Optional ) This parameter indicates that format 
tracks are to be written. Either this parameter 
or the zA parameter must appear on the card. 
(Optional) This parameter indicates that track 
addresses are to be written, "z" can be R or H, 
ra specifies full track with addresses, ha speci- 
fies full track with home address. Either this 
parameter or the fmt parameter must appear on 
the card. 

(Optional) This parameter indicates that a 
Write Disk Check is to be performed after each 
Write Disk operation. If omitted, no Write Disk 
Checks are performed. 

(Optional) The variable portion of this entry 
(nnnn) must be numerical and less than five 
digits long. It indicates the number of tracks 
in file Mxy to be passed before formatting and/ 
or record addressing is started. If this entry is 
omitted, zero is assumed. 

(Optional) This entry must be numerical and 
less than five digits long. It indicates the number 
of tracks to be formatted or addressed. If this 
entry is omitted, the whole file is assumed to be 
specified. Zero is an invalid entry. 
(Optional) This parameter indicates that a 
user's routine will be incorporated to generate 
non-standard record addresses. 



This card specifies the ha2. If the ha operation is to be 
performed, this is the home address that is written. If 
the ra operation is to be performed, the first two char- 
acters in this address are verified; however, the entire 
address must be punched. The card is punched in 
Autocoder format; however, the operand field can 
extend through column 80. One ha2 card is used for 
each job. Figure 17 shows the format of the HA2 card. 

hh. . . This is the HA2. The length can range from a 

minimum of 2 characters to a maximum of 60 
characters. 
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Figure 17. Format of HA2 Card 
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Note: The ibm 7631 File Control Unit handles only 
an 8-character disk control word, which contains an 
HA2 of two characters (the first two characters of the 
above HA2 ) . The remaining characters of the ha2 are 
disregarded. 

REC Card 

This card describes the format and record addresses 
to be generated. Any number of rec cards can be used. 

For standard record address generation, each group 
of two (minimum) or three (maximum) parameters 
defines a record. The first two parameters are required; 
the third is optional. The maximum group consists of: 
(1) the RA2 portion of the record address, (2) the 
number of records in the series and the record length, 
(3) and the padding character (optional). Each Rec 
card can contain as many groups as will fit on the card, 
however, each group on the card must be complete. 
Figure 18 illustrates the format of the rec card for 
standard record addresses. 

For nonstandard record address generation, a record 
address length parameter must be included in each 
group. This parameter indicates the length of the 
entire record address. The raOOOOOO parameter is used 
instead of RA2rr. 

Figure 19 shows the format of the rec card for non- 
standard record addresses. 

The entries for the rec card are as follows: 

RA2rr ... ( Required if standard addresses are gen- 

erated) This field must be at least five 
digits long. The first three are RA2. The 
rr . . . ( a minimum of two characters ) indi- 
cates the RA2 portion of the address and 
may use any characters except the comma. 

nnXgggg This parameter specifies the number of 

records and the length of each. The num- 
ber is specified by the nn portion. The entry 
must be numerical. (The program will 
accept the specification of three digits; 
however utilization of a file with this many 
records per track is uncommon. ) The gggg 
portion specifies the length of each record. 
It must be numerical and less than five 
characters long. The two portions must al- 
ways be separated by an X. 

p (Optional) This parameter specifies the 

character to be used for padding. It can be 
any character except a blank or a comma. 
If blank padding is to be used, the param- 
eter and its comma must be omitted. 

RAOOOOOO . . . This parameter is used only if nonstandard 
addresses are generated. It indicates the 
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Figure 18. Format of the rec Control Card for Standard Record Addresses 
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Figure 19. Format of the rec Card for Nonstandard Record 
Addresses 



length of the entire record address, ra iden- 
tifies the field. The number of zeros indi- 
cates the number of characters in the 
address. There must be at least six zeros to 
satisfy minimum address requirements. 



Figure 20 is an example of a rec control card. 

This control card defines 14 records for the file; one 
record of 500 characters, then 10 of 100 characters 
each, then 3 of 80 each. The records and their ad- 
dresses appear in the following order: 



ttttABLCI 
tttt50Q33 
tttt51Q33 
tttt52Q33 
tttt53Q33 
tttt54Q33 
tttt55Q33 



tttt56Q33 
tttt57Q33 
tttt58Q33 
tttt59Q33 
tttt3J454 
tttt30454 
tttt2R454 



The tttt is the address of the track on which these 
records appear; this will, of course, vary for each track 
in the file. The program adds 1 to the sixth digit of 
the record address to create the next succeeding record 
address when more than one record is defined by 
nnXgggg. The last three records show how the next 
address is obtained when a minus sign appears in 
the address; 3J (—31) becomes —30 (the zero is a 



minus zero ) and then 2R ( — 29 ) . Any carry to the 
left of these two positions is lost. 

Because more than one rec card may be used, a 
valid termination of a series of rec cards in one of 
the following: 

1. A mon$$ card 

2. A card that will cause another utility program to 
be executed (e.g., dump, save, resto, filgn). 

3. A form card 

Figure 21 is an example of a complete set of control 
cards for a job. 

The first card after the mon$$ exec utilities card 
indicates that file MR3 is to be formatted, addressed, 
and cleared. The next card indicates the ha2 is 
amplesixsixzero and will appear at the beginning of 
each track in this file. The two rec cards establish areas 
I for six records on each track of the file; the records 
are 380, 160, 380, 160, 160, and 380 characters long. 
The padding characters for these records are blank, 
R, blank, S, S, and blank, respectively. The addresses 
preceding the records are ttttAA, ttttOO, ttttAB, tttt02, 
tttt03, ttttAC, respectively. 

The second form card is a valid card for the con- 
trol program. It indicates there are no more rec cards 
for this format program. 



Error Conditions 

When an error occurs in a 1301 or 2302 Disk Format/ 
Address Generator program, the special-end-of- 
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Figure 20. Example of rec Control Card for Standard Record Addresses 
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Figure 21. Example of a Set of Control Cards for Execution of the ibm 1301 Disk Format/ 
Address Generator Program 
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program condition is set. When the program is operat- 
ing in a mode other than test, the following occurs: 
routines under control of the Utilities control routine 
are executed, but no succeeding programs are run until 
next job card is recognized. For example, assume that 
the following cards are in the siu ( line numbers appear 
at left for reference ) . 

01 MON$$ EXEQ UTILITIES 

02 FORM 



03 




HA2 





04 




REC 





05 




DUMP 





06 




FORM 





07 




HA2 





08 




REC 





09 


MON$$ 


EXEQ 


JOBA1 


10 


MON$$ 


EXEQ 


UTILITIES 


11 




DUMP 





12 


MON$$ 


JOB 






If an error occurs in the first format program, that 
program will not be completed. The print and format 
programs following (lines five and six) will be com- 
pleted, but no programs from the next exeq card ( line 
9 ) to the next job card ( line 12 ) will be executed. 

IBM 1301 and 2302 Disk For mat/ Address Generator 
Messages 

Two messages will be typed on the console when the 
2302 Disk/Format Address Generator is used. 
Before the format operation is started, the message set 

FORMAT KEY FOR 2302 MODULE, TYPE $50 will be typed. 

When the format operation has been completed, the 
message set format key to off, type $50 will be typed. 

When the message has been typed on the console, 
the program goes into the wait loop routine; when the 
operator has set the key off, he enters $50 and the pro- 
gram will continue. 

All invalid control cards are printed on the spr. In ad- 
dition, the following messages may appear on the spr (in 
each case the 10401 message appears on the console ) : 
symbolic unit not 1301 

The symbolic unit specified on the form card is not 

a 1301 Disk Storage Unit. 

SYMBOLIC UNIT NOT 1302 

The symbolic unit specified on the form card is not 
a 2302 Disk Storage Unit. 

SYMBOLIC UNIT ASSIGNMENT ERROR 

This message is caused by: 

1. Specifying a symbolic unit that is not assigned or 
is not an mrx-, MTy-, or Mwz-type unit. No for- 
matting is attempted. 

2. Defining the "nnnn" or "mmmm" on the form 
card so that formatting is requested beyond the 
limits of the symbolic unit. An attempt is made 
to format the available portion of the file. 

DISK WRITE ERROR 

Attempts to write on a track were unsuccessful. 



END OF 1301 FORMAT 

The program was successfully completed. 

END OF 1302 FORMAT 

The program was successfully completed. 

NO HA2 CARD 

No HA2 card was found immediately following the 
form card. 

NO REC CARD 

No rec card was found immediately following the 
HA2 card. 

READ ERROR ON HA2 

An error was detected while reading the ha2 card. 

NO IIA2 AND READ ERROR 

The card immediately following the form card was 
not an HA2 and contained an error. 

READ ERROR ON REC 

An error was detected while reading a rec card. 

NO REC AND READ ERROR 

The card immediately following the form card was 
not a rec card and contained an error. 

INVALID CARD 

A card was read that was not a valid termination 
to the format series. 

INVALID CARD AND READ ERROR 

A card that was not a valid termination to the format 
series was read. This card contained an error. 

INVALID HA2 

The indicated HA2 is less than two characters. 

INVALID RECORD DEFINITION 

This message is caused by one of the following 
conditions: 

1. The RA2 field was not found on the rec control 
card. 

2. The indicated ba.2 is less than two characters long. 

3. The nnXgggg field was not found on the rec con- 
trol card. 

4. The nn part of the nnXgggg field is zero. 

5. The gggg part of the nnXgggg field indicates a 
record of less than two characters. 

6. The nn part of the nnXgggg field is over three 
characters long, or the gggg part is over four 
characters long. 

track length error 

The records defined exceed the track length. 

WRONG LENGTH RA 

The nonstandard record address generated by the 

user's routine is longer than the area available on 

the track. 

Note: The 1311 Disk Format/Address Generator 
program is described in the publication Support of IBM 
1311 Disk Storage Drives Under the Operating System. 



20 



Other Utility Programs 



File Save Program 

The File Save program transfers data from specified 
areas of ibm 1301 or 2302 Disk Storage onto magnetic 
tape or punched cards. Both the magnetic tape and 
the punched card output are in a form that can be 
used as input to the companion File Restore program. 
The File Save program can record the contents of 
either (1) a symbolic unit or part of a symbolic 
unit or (2) one or more entire 1301 or 2302 disk 
surfaces, or a part of one or more surfaces. 

The symbolic unit type of operation transfers data 
from the unit specified on the save control card to 
magnetic tape or punched cards. The user can specify 
the limits of the symbolic unit area to be transferred, 
as with the Disk Print utility program (see "Disk 
Print Program"). 

The 1301/2302 disk-surface type of operation trans- 
fers the contents of all of a disk surface onto magnetic 
tape or punched cards. The starting point is specified 
on the save control card according to channel access 
arm, module, and address of the outermost track. 

The size of the output tape record is equal to the 
size of the disk record plus 11. Magnetic tape output 
of the File Save program is on mw2. If the data to be 
saved resides on 1301 Disk Storage, the output tape 
can be a maximum of 2,847 characters in length. If the 
data to be saved resides on 2302 Disk Storage, the 
output tape can be a maximum of 5,916 characters in 
length. 

If punched card output is specified, the File Save 
program places its output on the spu. The format of 
the cards is that of the standard Load card, with one 
exception: the relocation indicators are omitted. (See 
"Load Card" in the publication System Monitor. ) 

Each user should maintain a current set of format 
decks for his disk file, as well as a description of record 
addresses, ha2's, and record formats. 

Because of the possibility of changed data, the File 
Save program must not be used while a Tele-processing 
complex is open or while a Type III spool operation 
is being performed. The program cannot be used with 
shared disk files at any time when the other member 
of the sharing complex is operating on the data. 

SAVE Control Card 

The save control card specifies one area of disk stor- 
age to be recorded on tape. With the symbolic unit 
type of operation, data transfer can start at the begin- 
ning of a symbolic unit or a specified number of tracks 



from that point. With the disk-surface type of opera- 
tion, the start address must be the outermost track 
of the disk surface; however, data transfer may begin 
a specified number of tracks from that point. If the 
disk-surface type of operation is used, and more than 
one disk surface is to be saved, an additional control 
card must be included ( see "Optional Control Cards — 
Disk Surface Save," below ) . 

The first operand of the save card must be the type 
of disk unit (e.g., 1301); other operands may appear 
in any order. Omitted parameters need not be rep- 
resented by commas. 

The format of the save card is shown in Figure 22. 

The entries have the following meanings: 

130x This entry identifies the type of disk storage, 

"x" can be either 1 or 2. 

symunit This entry can be a symbolic unit (Mxy), or 
the camtttt start address (channel, access arm, 
module, and track) for a disk-surface save. If 
a symbolic unit (Mxy) is specified, x must be 
R, T, or W (i.e., the symbolic unit must be 
designated as a reserve, Tele-processing, or 
work file). If camtttt is specified, tttt must be 
the address of the outermost track of the disk 
surface. 

mode (Optional) This entry is LOAD or MOVE. If 

this parameter is omitted, Load mode is as- 
sumed. If a symbolic unit is specified, all tracks 
of the symbolic unit must be recorded in the 
same mode. 

PUNCH (Optional) This entry indicates that the speci- 
fied area of the file is to be punched on the spu 
in Load-card format. The option is used for 
manual correction of file errors; no tape output 
is written if the punch option is selected. If 
this parameter is omitted, the output is written 
on MW2 and no punched card output is pro- 
duced. 

+ xxxx (Optional) If this parameter is used, the first 
character must be a plus sign. The parameter 
specifies that the File Save program is to 
begin the transfer of data to be saved xxxx 
tracks from the starting point of Mxy. If this 
parameter is omitted, data transfer starts at the 
beginning of Mxy. 

Syyyy (Optional) If this parameter is used, it con- 

tains the number of tracks to be saved. The 
four-digit number must be preceded by S. If 
the parameter is omitted, the program con- 
tinues the transfer of data to the end of the 
specified unit. 

Gzz (Optional) The G in this operand indicates 

that the file to be saved is an iocs Form C file 
(sequential-geometric) and may be partitioned; 
zz indicates the number of records per track. 
If the number of records per track is less than 
ten, the number must be preceded by a zero. 
The Read Single Record instruction is used by 
the Utility program. If this parameter is omitted, 
the program uses the Read Full Track with 
Home Address instruction. This parameter has 
no significance for a disk-surface type of save. 
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Figure 22. Format of the save Control Card 



Figure 23 is an example of a save control card. The 
type of disk storage on which the file to be saved 
resides is 1301 ( first operand ) . The symbolic unit to be 
saved is mr3 (second operand). Since no mode is 
specified, Load mode is assumed. Because punch is 
not specified, the output is written on mw2 rather than 
the spu. Transfer of the data to be saved begins 22 
tracks ( third operand ) from fhe beginning of symbolic 
unit mr3. Because the number of tracks to be saved 
is not specified, transfer of data to be saved continues 
to the end of symbolic unit mr3. In the data transfer, 
the program uses the Read Single Record instruction 
( the last operand in the example specifies that the file 
to be saved is an iocs Form C file and contains six 
records per track ) . Note that the 6 in the last parameter 
must be preceded by a zero. 
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Figure 23. Example of the save Control Card 



Optional Control Cards — Disk Surface Save 

If the disk-surface type of operation is used, more than 
one surface can be saved through the inclusion of 
additional Save program control cards. These control 
cards, which must immediately follow the save card, 
allow the user to specify, on each card, one additional 
disk surface to be saved. The camtttt start address 
( channel, access arm, module, and track address ) must 
be the first entry in the operand field; the +xxxx and 
Syyyy parameters, designating the number of tracks 
to be passed over from the starting track and the 
number of tracks to be saved, respectively, can also be 
included. No entries can be placed in the label and 
operation fields of these optional cards. Because the 
start address is always the outermost track on the 
disk, tttt must be in the range of 0000 to 0039. 

Figure 24 shows the format of the optional control 
cards for a disk-surface save. 

Figure 25 is an example of the optional control cards 
necessary to save three disk surfaces in addition to the 
surface specified on the save control card. The cards 
must immediately follow the save control card. The 
first card indicates a method for saving the 26th 
through 75th tracks of the disk surface beginning with 



Figure 24. Format of the Optional Control Cards for a Disk 
Surface Save 
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Figure 25. Example of Optional Control Cards — Disk Surface 
Save 



track number 0005. The second card causes all 250 
tracks of the disk surface beginning with track number 
0006 to be saved. The third card causes all 250 tracks 
of the disk surface beginning with track 0008 to be 
saved. 



File Save Messages 

Error Indication on the Console Only 

When a disk read error that cannot be corrected occurs, 
the following message appears on the console: 

20401 ENTER $3R, $3A, Or $3S 

The operator must key in one of the following: 
$3R — to retry the input/output operation. 
$3A — to accept the record as read. 
$3S — to skip the record. 

If the operator keys in $3A or $3s, the contents of the 
erroneous track record are printed on the spr. 

Error Indications on the Console and SPR 

The following message may appear in the listing on the 
spr ( in each case the File Save program issues a 10401 
console message and sets a special end-of-program 
condition in Resident Monitor ) : 

SYMBOLIC UNIT NOT AVAILABLE 

A symbolic unit specified on the save card is not as- 
signed to any physical unit. The error causes termi- 
nation of the program; control is given to the Utility 
control routine. 

SYMBOLIC UNIT NOT 1301 

A symbolic unit specified on the save card is not a 
1301 Disk Storage unit. The error causes termination 
of the program; control is given to the Utility control 
routine. 



22 



SYMBOLIC UNIT NOT 1302 

A symbolic unit specified on the save card is not a 
2302 Disk Storage unit. The error causes termination 
of the program; control is given to the Utility control 
routine. 

SYMBOLIC UNIT MW2 NOT TAPE 

MW2 is assigned to a physical unit that is not a tape 
unit. The error causes termination of the program; 
control is given to the Utility control routine. 

UNCORRECTABLE ERROR ON MW2 

An uncorrectable input/output error occurred on 
symbolic unit mw2. The error causes termination of 
the program; control is given to the Utility control 
routine. 

Messages on the 5PR Only 

The following messages may appear in the listing on 
thesPR: 

END OF REEL ON MW2 

The magnetic tape output unit assigned to symbolic 
unit jmw2 has reached end-of-reel before all the 
records have been written. The program switches to 
the next reel. If no alternate unit is provided, a 20101 
cu console message is issued and a waiting loop is 
entered; this permits the operator to mount a new 
reel. Processing continues to the end of the disk file. 

END SAVE PROGRAM 

The program has been completed. The output tape 
file is rewound and unloaded. 



File Restore Program 

The File Restore program reads data produced by the 
File Save program and restores this data to the same 
area of ibm 1301 or 2302 disk storage from which it 
was taken. The data can be restored to either (1) a 
symbolic unit or part of a symbolic unit or (2) an 
entire disk surface or part of a disk surface. Input to 
the File Restore program can be either on magnetic 
tape or punched cards. 

If the input is on magnetic tape, the tape must reside 
on symbolic unit mw2. An option of the File Restore 
program allows the user to specify that input is Load 
card input produced by the File Save program. ( The 
cards are in standard Load card format except that the 
relocation indicators are omitted. ) As in the case of the 
File Save program, this option is used for manual cor- 
rection of file errors. It also provides an efficient 
method of restoring corrected data to the disk storage 
file. 

Because of the possibility of changed data, the File 
Restore program must not be used while a Tele- 
processing complex is open or while a Type III spool 
operation is being performed. The program cannot 



be used with shared disk files whenever the other 
member of the sharing complex is operating on the 
data. 

Restore Control Card 

The Restore control card (resto) specifies one area 
of disk storage to which data is to be restored. The 
format of the resto control card is shown in Figure 26. 

The first operand of the Restore card must be the 
type of disk unit; other operands may appear in any 
order. Omitted parameters need not be represented by 
commas. 

The entries have the following meanings : 

130x This entry specifies the type of disk storage, "x" 

can be either 1 or 2. 

symunit This entry can be a symbolic unit ( Mxy ) or 
the camtttt start address (channel, access arm, 
module, and track) for disk-surface restore. If 
a symbolic unit is specified, x must be R, T, or 
W (i.e., the symbolic unit to which the data 
is restored must be a reserve, Tele-processing, 
or Work file). If camtttt is specified, tttt must 
be the address of the outermost track of that 
surface. 

mode (Optional) This entry is LOAD or MOVE. If 

the entry is omitted, Load mode is assumed. 

PUNCH (Optional) This option allows the user to read 
cards punched in Load card format from the 
siu. The data contained on the cards is re- 
stored to the specified area of disk storage. If 
this parameter is omitted, the input is assumed 
to be on symbolic tape unit M W2. 

+ xxxx (Optional) If this parameter is used, the File 

Restore program skips xxxx records from the 
beginning of the tape assigned to MW2 and 
starts restoring data at that point on the tape, 
xxxx must be preceded by a plus sign. If this 
parameter is omitted, and the punch parameter 
is not specified, data transfer starts at the be- 
ginning of MW2. This parameter has no sig- 
nificance when used in conjunction with punched 
cards (i.e., when the punch parameter is speci- 
fied). 

Syyyy ( Optional ) If this parameter is used, it specifies 

the number of tape records to be restored in the 
operation. The four-digit number must be pre- 
ceded by an S. If the parameter is omitted, the 
File Restore program restores all the records 
saved. 

WDC This parameter specifies that a Write Disk Check 

be performed after each disk write operation. 

Gzz (Optional) The G in this parameter indicates 

that the file to be restored is an iocs Form C 
file (sequential-geometric) and may be parti- 
tioned; zz indicates the number of records per 
track. If the number of records per track is less 
than ten, the number must be preceded by a 
zero. If this parameter was specified on the 
save control card for the File Save program, 
the Gzz parameter in the File Restore program 
must be the same. The Read Single Record 
instruction is used by Utility program. If this 
parameter is omitted, the program uses the 
Write Full Track with Home Address instruc- 
tion. This parameter has no significance for a 
disk-surface type of restore. 
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Figure 26. Format of the resto Control Card 



Figure 27 is an example of a resto control card. The 
type of disk storage to which the file is restored is 1301 
(first operand). The symbolic unit to which the data 
is restored is mr2. Since no mode is specified, Load 
mode is assumed. Because punch is not specified, the 
data is restored from mw2 rather than from the siu. 
174 records ( tracks on disk ) are skipped from the tape 
assigned to MW2 and the restoring begins with the 
175th record on tape into the 175th track from the 
beginning of symbolic unit MR2; 326 tracks of data 
( fourth operand ) are restored. In the data transfer, the 
program uses the Read Single Record instruction (the 
last operand in the example specifies that the file to be 
restored is an iocs Form C file and 35 records per track 
must be written). If this resto card were used to re- 
store data saved through use of the save card shown 
in Figure 23, the last parameter would have to be G06. 



Label Operation 
1!S 19. 



A.^^.... <? £.S.r,0 L£QJ.» At&JU±J.2£.j .SJJA^JSJA 



Figure 27. Example of the resto Control Card 

File Restore Messages 

The following messages may appear in the listing on 
the spr. In each case except the end restore program 
message, the program issues a 10401 console message 
and sets a special end-of-program condition in Resi- 
dent Monitor. 

symbolic unit not available 

A symbolic unit specified on the resto card is not 
assigned to any physical unit. The error causes ter- 
mination of the program; control is given to the 
Utility control routine. 

SYMBOLIC UNIT NOT 1301 

A symbolic unit specified on the resto card is not a 
1301 Disk Storage unit. The error causes termina- 
tion of the program; control is given to the Utility 
control routine. 

SYMBOLIC UNIT NOT 1302 

A symbolic unit specified on the resto card is not 
a 2302 Disk Storage unit. The error causes termina- 
tion of the program; control is given to the Utility 
control routine. 



SYMBOLIC UNIT MW2 NOT TAPE 

MW2 is assigned to a physical unit that is not a tape 
unit. The error causes termination of the program; 
control is given to the Utility control routine. 

FILE ON MW2 DIFFERS FROM CONTROL CARD 

The file on symbolic unit MW2 does not correspond 
to the file specified in the resto control card. The 
error causes termination of the program; control is 
given to the Utility control routine. 
*** card seq err *** ( contents of card) 
One of the punched cards containing data to be 
restored is not in the correct sequence. (The user 
had specified the punch option in the File Save 
program, and the order of the deck \as been 
changed. ) 
uncorrectable error on MW2 

An uncorrectable input/output error occurred on 
symbolic tape unit MW2. The error causes termina- 
tion of the program; control is given to the Utility 
control routine. 
end restore program 

The program has been completed. 
Note: When a disk error that cannot be corrected 
occurs, no message is issued; the erroneous track rec- 
ord is printed on the spr and the program is ter- 
minated. 



Data File Generator Program 

The Data File Generator is a Utility program used 
primarily to produce data files for testing purposes. The 
program allows the user to create files in various for- 
mats; the files produced by the Data File Generator 
may serve as input to the program(s) being tested. 

The Data File Generator module exists as one phase 
in the complete utilities program package. For execu- 
tion of the program, the following control cards are 
required (in addition to the mon$$ exeq utilities 
card) : the filgn Data File Generator card (see Figure 
28) and the fgn file-specification control card. File- 
specification control cards describe the type of file to 
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Figure 28. filgn Control Card 
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be generated. The user can also include several op- 
tional file -specification control cards. 

When the utility scan routine encounters a filgn 
card, the utility control routine loads the Data File 
Generator program and transfers control to that pro- 
gram. Subsequent file-specification and data cards are 
read by the Data File Generator program. 

Data cards must contain all the data to be included 
in the file. These cards are placed on the siu or aiu. 
File-specification control cards, with the exception of 
the fgn card, may be interspersed among the data 
cards. 



Input Specifications 

Input to the Data File Generator program can be in 
punched card or card-image format; the data cards 
must reside on the siu or aiu with the control cards. If 
the user is generating Form 1, 2, or 3 records (see 
Basic Input/Output Control System), data from a 
selected portion of the input card can be used; in the 
fgn file-specification control card, the user specifies the 
first and last input-card columns containing data. Each 
new record must begin in the first specified data column 
of a new card. 

An input card set consists of the file-specification 
control cards and the input data cards; several input 
cards sets can be used during one execution of the 
Data File Generator program. One data file is produced 
for each input card set. When a new input card set is 
read the program destroys the control information for 
the previous set. The first card in each input card set 
must be the fgn card for that set. 

If the user is generating Form 1 or Form 3 data rec- 
ords his input cards must contain a record mark and 
group mark in the last two data columns for each rec- 
ord. This requirement enables the user to build files of 
variable-length records. The record mark and group 
mark may appear anywhere within a data area as long 
as the two characters will be adjacent to each other in 
core storage; for example, if columns 24-60 are speci- 
fied as the data area, a record mark could appear in 
column 60 of one input card and the group mark in 
column 24 of the next card. However, if the record 
mark and group mark appear in any data columns 
other than the last two on the card, all succeeding data 
columns on that card are ignored. The next record be- 
gins on the first data column of the next card. Thus, in 
the above example, columns 25 through 60 of the card 
containing the group mark in column 24 are ignored. 

If the user wishes to generate a file containing Form 
4 records, he must specify on the fgn control card the 
low-order position of the Record Character-Count field. 
The Record character-count field that this entry points 



to must contain numeric data. If the data records span 
more than one card, the low-order position of the 
Record Character-Count must be located on the first 
input data card (i.e., the location specified by the user 
must be within the first eighty columns of the data 
record). The user also specifies on the fgn card the 
number of characters in the Record Character-Count 
field. Form 4 records are generated in Load mode and 
the user must specify Load mode on the fgn card. 

Ofher Group-Mark and Record-Mark Considerations 

The record mark and group mark pair required for 
generation of Form 1 or Form 3 data records is not 
counted in the user's FGN-card block size specification. 
In the generation of all record forms group marks are 
acceptable as data; however, a data group mark cannot 
appear in column 1 of an input data card. 

If Form 2 records are generated, the user's block size 
and record length entries on the fgn card must reflect 
the presence of the record mark; in this case, the record 
mark is added by the Data File Generator program. 
Form 2 records are the only records for which the pro- 
gram generates a record mark ( if record marks are de- 
sired for other record forms, the user must include the 
record mark in the input data ) . 

Example: A user wishes to generate Form 2 records, 
225 characters each (including the record mark), two 
records per block, and to use columns 10-72 of the input 
data cards to contain the data. The following list shows 
the input data card sequence for one block, the number 
of characters on each card, and the columns containing 
the characters : 







CARD COLUMNS 


CARD 


NUMBER OF 


CONTAINING THE 


SEQUENCE 


CHARACTERS 


CHARACTERS 


1 


63 


10-72 


2 


63 


10-72 


3 


63 


10-72 


4 


35 


10-34 
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63 


10-72 


6 


63 


10-72 
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63 


10-72 


8 


35 


10-34 



The user specifies the record length of 225 characters 
in columns 6-9 of the fgn card, and a block size of 
0450 in columns 10-13 of the fgn card. The Data File 
Generator program places a record mark in the 225th 
position of each record. 



Output Specifications 

The user indicates the nature of the output file via 
the fgn and optional file-specification control cards. 



Other Utility Programs 25 



Output from the program can be written on magnetic 
tape or ibm 1301 or 2302 Disk Storage. MW4 is the 
output symbolic unit unless the user specifies a dif- 
ferent unit. The user can generate Form 1, 2, 3, or 4 
records (the description and specifications for each 
of these record forms are contained in Basic Input/ 
Output Control System). Maximum output tape record 
size is 9000 characters. Maximum output disk record 
size is as follows: 





1301 


1302 


Move mode 


2800 


5850 


Load mode 


2165 


4533 



Output can be written in Move or Load mode. 
Form 4 records, however, must be written in Load 
mode. If Form 2 records in Load mode are written, 
the program can be used to add word marks to the 
records (see "wmk" control card). The user can spec- 
ify the parity (even or odd) in which the output file 
will be written. Multireel files or multifile reels can 
be generated; output of both types can be produced 
during one execution of the Data File Generator pro- 
gram. If disk files are being generated, the Write Disk 
Check option is available. 

For generation of Form 3 and Form 4 records, the 
user has the option of including a word mark in the 
high-order position of the Block Character-Count field; 
an A and a B bit are always generated in the low- 
order position of this field. The Block Character-Count 
is calculated by the program and inserted in Form 3 
and Form 4 records; the user's specification on the 
fgn card of the block size or maximum block size 
must reflect the presence of the Block Character-Count. 



Tape-Label Options 

If the user wishes the Data File Generator program 
to process tape labels, he must communicate all tape- 
label information via the lbl file-description control 
cards. Omission of this card indicates that tape labels 
are not to be processed. 

If labeled files are to be produced by the Data File 
Generator program, the second parameter of the 
System Generation iokdf macro-statement must be "D." 
If "D" is not specified, the appropriate exits will not 
be available to the program. 

Tape labels alone cannot be written by the Data File 
Generator. At least one data record must be included. 

Formats for header and trailer labels are entirely 
independent of each other. The user may elect to 
write both header and trailer labels, only header labels, 
or only trailer labels. He may specify the processing 
of ibm 1410 80-character labels, ibm Standard 120- 
character labels, or nonstandard labels. Having ini- 



tiated the writing of one particular type of label, the 
user may at any subsequent time change the label 
format or cancel the writing of tape labels. If ibm 1410 
80-character labels or ibm Standard 120-character 
labels are processed, the user has the option of having 
the iocs check, on output, the retention period of the 
old header label. 

Other IOCS Options 

Several additional iocs options can be specified for 
inclusion during the execution of the Data File 
Generator program. The user can bypass uncorrect- 
able erroneous records, or process them as if they were 
error-free ( see "erroptns" in Basic Input/Output Con- 
trol System). He can take advantage of the iocs re- 
wind options ( see "rwdoptns," also described in Basic 
Input/Output Control System). Both the erroptns 
and rwdoptns features are indicated via the fgn file- 
specification control card. 

Two iocs macro-instructions can be executed by 
control-card specification. These macro-instructions 
are: (1) ioctl relse, output, file, and (2) ioctl feor, 
output, file. The control cards for each are the rls 
card and eor card, respectively. The point at which 
the card is included in the input data deck determines 
the point during processing at which the macro- 
instruction is executed. 

Data File Production 

A single input card set, which produces one data file, 

consists normally of the following cards : 

FILGN 

FGN — control card 

LBLH (optional) 

DATA - cards 

LBLT (optional) (LBLT — card can also precede data 

cards ) 

END 

If a multifile data-file is wanted, the card set nor- 
mally consists of several input card sets (i.e., for form 
1 records). 

FILGN 

FGN control card for file 1 

LBLH card for file 1 ( optional ) 

DATA cards for file 1 

LBLT card for file 1 ( optional ) 

EOF for file 1 

FGN control card for file 2 
LBLH card for file 2 ( optional ) 
DATA cards for file 2 
LBLT card for file 2 ( optional ) 
EOF for file 2 

FGN control card for file n 
LBLH card for file n ( optional ) 
DATA cards for file n 
LBLT card for file n (optional) 
END 
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The rewind options on respective fgn control cards 
must be chosen so that the different files do not overlay 
each other when generated on the same tape by caus- 
ing the iocs to rewind the tape every time a file is 
opened/closed. 

The eof card, which after closing the files termi- 
nating the current input card set, directly calls in the 
Data File Generator program by branching to the load 
routine, can be replaced by an end card. 

In this case, the following input card set must be 
preceded by a filgn card because the end card passes 
the control to the utility control program after closing 
files and terminating execution. The above remark 
about rewind-option is also valid in this case. 

Every end and/or eof card also generates a tape 
mark on the output file. 

Data File Generator (FILGN) Control Card 

The Data File Generator (filgn) control card speci- 
fies to the Utilities control routine that the Data File 
Generator program is to be executed. The card con- 
sists of only one entry: filgn in columns 16-20 (see 
Figure 28). 

File-Specification Control Cards 

The file-specification control cards used with the Data 
File Generator program include one required and six 
optional cards. To achieve their desired effect, the 
control cards must be placed at specific positions 
within the input card set. Leading zeros in numeric 
data must be included on all cards. 

FGN Control Card 

The fgn card is required and must be the first card 
in an input card set. (Each input card set produces 
one data file; several data files can be produced during 
an execution of the Data File Generator program by 
including additional sets of cards.) An input card set 
cannot include more than one fgn card. 

The format of the fgn card, the possible entries 
for each field, and the explanation of the entries are 
as follows: 



MEANING OR FUNCTION 

Card identification: 

Generate a magnetic tape file. 

Generate a 1301 Disk Storage file. The 
Full Track Witout Record Addresses 
instruction is used. 

Generate a 1302 Disk Storage file. The 
Full Track Without Record Addresses 
instruction is used. 

Record form indication. The entry sig- 
nifies the desired form of the records 



CARD 


POSSIBLE 


COLUMN 


ENTRIES 


1-3 


FGN 


4 


T 




1 



CARD POSSIBLE 
COLUMN ENTRIES 



6-9 XXXX 

yyyy 

bbbb 
10-13 xxxx 



yyyy 



14 



15 



M 
L 
1 or b 



16 



1 or b 



17 



18 



19 



1 or b 



n or b 



1 or b 



1,2,3, or 4 



MEANING OR FUNCTION 

on the generated file. The numbers cor- 
respond to iocs record-form defini- 
tions ( see Basic Input /Output Control 
System ) . 

For Form 2 records: the length of the 
record. The record mark added to each 
record by the Data File Generator 
must be included in the count. 

For Form 4 records: the low-order 
position of the Record Character-Count 
field. The entry cannot be greater than 
0080. 

For Form 1 or Form 3 records: the 
field must be left blank. 

For Form 2 records, or Form 1 or 
Form 3 fixed-length records: the size 
of the block. If Form 3 records are 
generated, this figure must reflect the 
Block Character-Count field. (For 
complete information on determining 
this figure, see "blocksize" in Basic 
Input/Output Control System. ) 

For Form 4 records, or Form 1 or 
Form 3 variable-length records: the 
maximum block size. If Form 3 or 4 
records are generated, this figure must 
reflect the Block Character-Count field. 
(See Basic Input/Output Control Sys- 
tem.) 

Write the output in Move mode. 

Write the output in Load mode. 

This entry corresponds to the iocs 
erroptns options. A 1 indicates that 
during the execution of the Data File 
Generator program, all uncorrectable, 
erroneous records are to be skipped. 
A blank indicates that all uncorrectable, 
erroneous records are to be processed 
as though they were error-free. 

Parity indicator. A 1 signifies that the 
program should write the magnetic 
tape output in odd parity. A blank in- 
dicates that either the program should 
write the magnetic tape output in even 
parity, or that the output is not on 
magnetic tape. 

Write Disk Check indicator. A 1 sig- 
nifies that a Write Disk Check should 
be performed after each write disk 
operation. A blank indicates that this 
operation should not be performed. 

For Form 4 records: the number of 
characters in the Record Character- 
Count field (n=l, 2, 3, or 4). If 
records in any other form are being 
generated, this field should be blank. 

If Form 3 or Form 4 records are be- 
ing generated, and the user desires a 
word mark in the high-order position 
of the Block Character-Count field, this 
entry should be a 1. If the option is 
not desired, or no Block Character- 
Count field will be present ( Form 1 or 
Form 2 records ) , this entry should be 
a blank. 
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CARD 


POSSIBLE 


COLUMN 


ENTRIES 


20-23 


XXXX 



24-25 xx 



bb 



26-27 xx 



MEANING OR FUNCTION 

This entry indicates the iocs rewind 
options desired; each character may 
be either R, U, N, or B. (See the 
"rwdoptns" in Basic Input/Output 
Control System.) 

For Form 1, 2, and 3 records: this 
entry indicates the card column in 
which the data for the file begins. 

For Form 4 records: this field must be 
blank. 

For Form 1, 2, and 3 records: this 
entry indicates for each card the last 
card column in which data for the file 
appears. 



bb 



28-30 xxx 



For Form 4 records: this field must 
be blank. 

This entry indicates the symbolic unit 
for output. This symbolic unit may be 
a work, reserve, or Tele-processing 
file. 

bbb If the field is left blank, mw4 is as- 

sumed. 

31-80 (Optional) Comments or information may be in- 
cluded in this field. 

An example of the fgn control card is shown in 
Figure 29. Information provided by this card is as 
follows: 



information 
fgn card. 

Data file will be on tape. 
Form 2 records will be gen- 
erated. 

Records will be 80 characters 
long. 

Each block will be 800 
characters. 

File will be written in Load 
mode. 

"Accept" iocs option will be 

used. 
Magnetic tape will be written 

in even parity. 

Write Disk Check feature will 
not be used. 

There will be no Record- 
Character Count. 

There will be no Block- 
Character Count. 

rruu rewind options will be 
used. 

Data begins in column 01. 

Data ends in column 80. 

Output will be on MW4. 

No comments are included. 



CARD COLUMNS 
PROVIDING information 

1-3 
4 

5 

6-9 

10-13 

14 

(no entry in 15) 

( no entry in 16 ) 

( no entry in 17 ) 

( Column 18 must be blank) 

( Column 19 must be blank ) 

20-23 

24-25 

26-27 

(no entry in 28-30) 

(31-80 is blank) 



. 


2 


3 


4 


5 


8 


7 


8 


9 


.0 


1. 


12 


.3 


14 


is 


16 


17 


IS 




K 


O 


23 
U 


24 




1 


8 


27 




28 


20 


3D 


31 


32 


33 


34 


35 


36 


37 


3B 


39 






42 




F 


6 


N 


T 


2 








8 








8 








L 


















































w 
















1 






1 



Figure 29. Sample fgn Control Card 
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WMK Control Card 

The wmk control card is optional; if used, it must be 
placed immediately after the fgn card. Only one wmk 
control card may be included with each input card set. 

The wmk card can only be used when Form 2 
records in Load mode are generated. The program will 
add word marks at the specified positions. 

Up to 19 word marks for each record can be speci- 
fied. Columns 1 through 3 on the control card must 
contain the letters wmk. Columns 4 through 79 are 
divided into 19 fields of 4 positions each. Starting in 
the first field (columns 4 through 7), the user indi- 
cates the position, within the record, at which the 
word mark should be placed. If more word marks are 
desired, their positions are indicated in the succeeding 
wmk card fields (columns 8-11, 12-15, 16-19, . . . . , 
76-79 ) . The first blank field on the card ( bbbb ) indi- 
cates to the program that all word mark positions have 
been specified. All succeeding columns must be blank. 
Column 80 must always be blank. The columns speci- 
fied on the wmk card can be in any order. 

An example of the wmk control card is shown in 
Figure 30; the card specifies word marks in columns 
17, 26, and 43. 



36 37 38 39 



Figure 30. Sample wmk Control Card 



LBL Control Card 



The lbl control card is optional; if used, it must con- 
tain all information necessary for processing of tape 
labels. Until the Data File Generator encounters an 
lbl card, the program assumes that labels are not to be 
written. The lbl card also permits the user to specify 
a retention-period check, lbl cards may appear any- 
where after the fgn card and within the input card 
set to which they pertain. 

The format of the first eight columns of the lbl card, 
the possible entries for each field, and the explanation 
of the entries are as follows: 



CARD POSSIBLE 
COLUMN ENTRIES 



1-3 
4 



LBL 
H 



6-8 



N 

080 or 120 



MEANING OR FUNCTION 

Card identification. 

Information on this card is for header 
labels. 

Information on this card is for trailer 
labels. 

ibm 1410 80-character labels or ibm 
Standard 120-character labels will be 
written. 

Nonstandard labels will be written. 

Length of the label. 



The fields in columns 9 through 80 vary for each 
combination of characters in columns 4 through 8. 
Figures 31 through 42 show the control card formats 
as based on the entries in columns 4 through 8. 

In Figures 31, 32, and 33, rrrr, ffffffffff, sssss, and 
qqqq represent the retention period, file identification, 
file serial number, and reel sequence number, respec- 
tively. The user should place the appropriate informa- 
tion in these lbl card fields. If ibm 1410 80-character 
labels are generated, the high order position of the 
retention period field, and the high order position of 
the reel sequence number field, should each contain 
a zero. An explanation of the information for all these 
fields can be found in the publication Basic Input/ 
Output Control System. 

An asterisk in the high-order position of the reten- 
tion period, file identification, file serial number, or 
reel sequence number field in the lbl card signifies 
that no alteration to the corresponding File Table field 
should be made. Therefore, the name by which the 
file is known should not include an asterisk in the high- 



order position. If no asterisk appears in the high- 
order position of the particular field, information for 
that field is transferred directly to the corresponding 
area in the File Table. 

The x in column 32 of Figures 31 and 32 refers to 
the retention-period check option. If the user wishes 
to check the retention period, of the old header label, 
he must place a 1 in this field. If no check is desired, 
column 32 must be blank. 

The miscellaneous fields indicated in Figures 31, 
32, 33, and 34 may contain any information the user 
wishes to include. The length of the fields are in 
accordance with iocs format specifications (see Basic 
Input/Output Control System ) . In the figures illustrat- 
ing lbl control card format for nonstandard labels 
(Figures 35 through 42), the letter in column 9 in- 
dicates whether the card contains the first or second 
half of the label. If the card contains the first half of 
the label, an A must be placed in column 9: if the 
card contains the second half of the label, a B must 
be placed in column 9. 



?? 



37 38 39 40 

b\Ab\b 



41J42 43 



45 46 



i>\t>\ b 



51 52 

b\b 



b m 



Figure 31. lbl Card Format for ibm Standard 120-Character Header Labels 



1 

I 


2 


3 


4 


5 


« 


i 


8 


9 


10 


ii 


12 


13 
7 


14 


15 
f 


16 

7 


17 

7 


18 
/ 


19 
f 


f 


21 
7 


22 
f 


23^4 

S\S 

T. 


25 

s 

... 


26 

s 


27 

s 


28 
1 


29 
7 


30 

9 


31 


32 
X 


33 34 35 36 

b\b\b A 


37 38 

b\b 


b,b 

1. -. 


41 42 

m\i 
. L. 


43 44 45 

5jcj<? 
...1-1. 


46 

7 


47 
7 


43)49 

a\n 

-1 

,.L. 


50 

e 


51 



52 

u 


53 

s 


54 


55 


56 


57 


58 


59 


60 


61 


62 


63 


64 


65 


66 


67 


68 


69 


70 


71 


72 


73 


74 


" 


76 


77 


76 


79 


80 


B 


L 


/V 


5 





8 





r 


r 


r 


r 


























- 




























_ 









































Figure 32. lbl Card Format for ibm 1410 80-Character Header Labels 



1 
L 


2 
& 


3 
L 


4 
T 


5 
S 


6 
/ 


7 

2 


8 




9 


10 


11 


12 


13 


14 


15 


16 


17 


18 


19 


20 


21 


22 


23 


24 


25 

s 


26 

s 


27 

5 


28 

2 


29 
1. 


30 
f 


31 

1 


32 

6 


33 
b 


34 35 
b\b 


36 

6 


37 
b 


38 
b 


™T~" 
39J 40 


41 

b 


42 

b 




44 45 


46 
b 


47 
b 


4b{ 49 

b\b 


b 


51 52 53 

b\b\b 

tr 


34 
b 


55 
b 


56 

"b 


37 
b 


be 

b 


59 
b 


60 
b 


61 

m 


62 
/ 


63 

s 


64 65 66 

c \e / 


67 
/ 


68 

a 


69 

n 


70 

e 


71 
O 


72 
U 


73 
S 


74 


75 


76 


77 


" 


79 


80 


r 


r 


r 


r 


f 


f 


f 


7 


f 


7 


/ 


/' 


/ 


7 


s 


s 
















- 






































! 




1 1 






1 
1 



Figure 33. lbl Card Format for ibm Standard 120-Charaeter Trailer Labels 



1 

I 


2 


3 


4 


5 


6 


7 


a 


9 


10 


11 


12 


13 


14 


15 


16 


17 


18 


19 

n 


20 

e 


21 



22 
U 


23 
S 


24 


25 


26 


27 


28 


29 


30 


31 


32 


33 


34 


35 


36 


37 


38 


39 40 


41 


42 


43 


44 45 


46 


47 


48 


« 


50 


51 


52 


53 


54 


38 


56 


57 


58 


59 


60 


61 


62 


63 


64 


65 


66 


67 


6fl 


69 


70 


71 


72 


73 


74 


'» 


76 


77 


78 


79 


80 


B 


L 


T 


5 





a 





b 


b 


<n 


/ 


s 


c 


e 


/ 


/ 


a 


























1 


















































































- 


















- 




- 


























- 















































































































Figure 34. lbl Card Format for ibm 1410 80-Character Trailer Labels 



1 

L 


2 


3 


4 


3 


6 


7 


8 


9 


10 


u 


12 


13 


14 


IS 


16 


17 


16 


19 


20 


21 


22 


23 


24 


25 


26 


27 


28 


29 


30 


31 

7 


32 
/ 


33 

r 


34 
s 


t 


36 


37 

h 


38 

a 


39 


40 
f 


41 


42 
O 


43 


44 


45 

/ 


46 


47 


48 


49 

7 


30 


51 


52 


53 


54 


S3 


56 


57 


SB 


39 


60 


61 


62 


63 


64 


63 


66 


67 


68 


69 


70 


71 


72 


73 


74 


75 


76 


77 


78 


79 


80 


B 


L 


H 


N 


/ 


2 





A 


b 


b 


b 


b 


b 


b 


b 


b 


b 


b 


b 


















( 


a 


b 


e 


) 
















' 














































- 


- 




- 


- 


._. 




- 
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J 









































Figure 35. lbl Card Format for the First Half of a 120-Character Nonstandard Header Label 



1 
L 


B 


3 
L 


4 
H 


5 


15 



7 

3 


a 



9 
A 


10 
b 


11 
b 


12 
b 


13 
"b 


14 

b 


IS 

b 


16 

b 


17 

b 


18 
b 


19 

b 


20 
b 


21 

9 


22 

b 


23 


24 


25 


26 


27 


28 


29 


30 


31 


32 


33 


34 


35 


36 


37 


38 


39 


40 


41 


42 


43 


44 


43 


46 


47 


48 


49 


SO 

7 


SI 


52 

r 


53 
s 


54 
t 


35 


56 


57 


/ 


39 
f 


60 


61 


62 


63 64 

1/ 


65 66 

*|4 


67|68 

T 


69 


70 


71 


72 


73 


74 


75 


76 


77 


78 


79 


80 


b 


b 


t> 


b 


b 


b 


b 


b 


b 






b 


b 


b 




L 




( 


UV 






" 














a 1 








- 


























































1 




















1 








! 


































1 



















Figure 36. lbl Card Format for the First Half of an 80-Character Nonstandard Header Label 
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1 

L 


2 

B 


3 

L 


4 


■ 


6 


» 


a 


9 


10 


ii 


12 


13 


14 


13 


16 


17 


18 I9I20 

b\b\b 


21 22 


23 


24 


23 


26 


27 


28 


29 


30 


31 


32 


33 


34 


33 


36 


37 


38 39 


40 


41 


42 


43 


44 


49 


46 


47 


46 


49 


30 31 


32 


S3 


34 


55 


96 


57 


99 


39 


60 


61 


62 


63 


64 


63 


66 


67 


68 


69 


70 


71 


72 


73 


74 


73 


76 


77 


76 


79 


60 


N 


/ 


2 


<? 


3 


A 


b 


& 


/» 


b 


A 


b 


1 




















(ser.An 


{ 


h 


uf 


of hi 


e 


q 












































J. J 
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Figure 37. lbl Card Format for the Second Half of a 120-Character Nonstandard Header Label 



1 
L 


2 
8 


3 

L 


H 


3 

N 


6 




7 

8 


6 




B 


10 
b 


11 
b 
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b 


13 
b 


14 
b 


15 
b 


16 
b 


17 
b 


18 19 


20 
4 


21 
b 


22 

4 


23 


I 


29 


26 
i 


27 


28 
I 


29 
4 


30 
4 


31 

t 


32 
4 


33 
b 


34 


39 


36 
b 


37 

4 


3B 
b 


39 


40 

4 


41 


42 


43 


44 


43 


46 


47 


4B 


49 50 31 


32 


S3 54 55 96 

(ser.cn 


97 


58 39 60 61 62 63 64 


65 
I 


66 


67 


68 


69 


70 


71 


72 


73 


74 


73 


76 


77 


76 


79 


80 


































































- 




































1 





















Figure 38. lbl Card Format for the Second Half of an 80-Character Nonstandard Header Label 
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3 
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4 
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5 


6 


7 
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9 


10 


11 


12 
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17 


18 


19 


20 


21 


22 


23 


24 


23 


26 


27 


28 


29 


30 


31 


32 


33 


34 


33 


36 


37 


36 


39 


40 


41 42 43 44 49 46 47 48 49 SO 


51 

e 


32 


S3 


94 


S3 


36 


57 


38 


39 


60 


61 


62 


63 


64 


63 


66 


67 


66 


69 


70 


71 


72 


73 


74 


7S 


76 


77 


78 


79 


60 


/ 


7 





A 


b 


b 


b 


b 


b 


A 


^ 


b 


4 


b 


4 
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Figure 39. lbl Card Format for the First Half of a 120-Character Nonstandard Trailer Label 
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Figure 40. lbl Card Format for the First Half of a 80-Character Nonstandard Trailer Label 
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Figure 41. lbl Card Format for the Second Half of a 120-Character Nonstandard Trailer Label 
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Figure 42. lbl Card Format for the Second Half of an 80-Character Nonstandard Trailer Label 



Figures 43 and 44 illustrate lbl cards used for dis- 
continuing the writing of the current type header labels 
or trailer labels, respectively. 
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Figure 43. lbl Card for Discontinuing the Writing of the 
Present Type of Header Labels 
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Figure 44. lbl Card for Discontinuing the Writing of the 
Present Type of Trailer Labels 



Other File-Specification Control Cards 

Up to four additional file-specification control cards 
may be included at appropriate points within the input 
card set. The rls card causes the iocs to execute the 
ioctl relse, output, file macro-instruction. The eor 



card causes the iocs to execute the ioctl feor, output, 
file macro-instruction. The eof card causes the pro- 
gram to close the files, terminate the processing of the 
current input card set, and prepare for the processing 
of the next input card set. The end card causes the 
program to close the files, terminate execution, and 
pass control to the utility control program. Each of 
these four cards requires only the appropriate mne- 
monic (rls, eor, eof, or end) in columns 1-3. The 
contents of columns 4-80 are Optional. Figures 45 
through 48 illustrates these cards. 
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Figure 45. rls Card 
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Figure 46. eor Card 
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Figure 47. eof Card 
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Figure 48. end Card 

Data File Generator Messages 

All valid control cards are printed on the spr. In addi- 
tion, the following messages may be issued on the spr: 

end OF JOB 

Execution of the Data File Generator program has 
been completed. 

END OF FILE ON DISK 

The 1301 disk area(s) comprising the specified sym- 
bolic output unit has been filled with records. The 
program searches for an eof, end, or fgn card; Data 
File Generator cards not of this type are bypassed. 
If an fgn card is encountered, the program processes 
the new input card set. 

ERROR — CARD OUT OF SEQUENCE 

A card that must be in a specific position in the 
input card set (e.g., the fgn card) is not in that 
position. Remaining cards in the input card set 



are bypassed, and the "all cards neglected . . ." 
message issued. 

ERROR — RECORD EXCEEDS BLOCKSIZE — ERRPROC CONTROL 
CARD OPTION FOLLOWED 

One of the records read by the Data File Generator 
program exceeds the blocksize specified in the fgn 
control card. The program accepts or skips the rec- 
ord in accordance with the error option indicated in 
column 15 of the fgn card. 

INVALID END OF JOB 

The program has completed execution but the de- 
sired results may not have been obtained. 

error — ( erroneous entry ) 

One of the entries in a file-specification control card 
is in error. The error may have occurred, for exam- 
ple, in one of the following fields in the fgn control 
card: record form, file medium, mode, rewind option, 
parity option, Write Disk Check option, record size, 
or blocksize. Remaining cards in the input card set 
are bypassed, and the "all cards neglected. . ." 
message issued. 

ALL CARDS NEGLECTED UNTIL NEXT EOF OR END CARD 

During the execution of the Data File Generator 
program, an error occurred that necessitated the 
bypassing of the remaining cards in input set. A 
new input card set, if present, is processed. If no 
additional input card set is present, the program 
gives control to the Utility control routine. 



Other Utility Programs 31 



Index 



Where more than one page reference is given, the 
major reference appears first. If an index entry refers 
exclusively or primarily to one utility program, the 
name of the program is given in parentheses. 

all entry (Storage Print) 10 

Asterisk, use of 9, 11, 29 

Asterisk-Insert Switch 12 

Autocoder calling sequence for Snapshot 8, 9 

Blank storage areas, representation of 9 

Block Character-Count field 26 

Console messages 5, 20, 22 

Control card errors, Utility control cards 6 

Parameter-specification errors 6 
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Control cards 

Data File Generator (filgn card) 26, 6, 19, 24, 25 

Disk Print ( Disk dump card ) 15, 6 
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fgn card (Data File Generator) 26, 25, 27, 31 

File Restore (resto card) 23-24, 6, 19 
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rls card ( Data File Generator ) 26, 30 
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Tape Print (tape dump card) 13, 14 

wmk card (Data File Generator) 28 

Control of print programs 8 

Control of utility programs 6 

Core Image file, in Storage Print 10, 11, 12 
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Previously prepared file, use of 10 

Data cards ( Data File Generator ) 25 

Data File Generator program 24-30, 6 

Control cards 26-31, 6 

Input card set 25 

Input specifications 25 

iocs options 26 

Messages 31 

Output specifications 25-26 

Tape-label options 26 

Disk Format/Address Generator programs 17-20, 6 

Control cards 17-19 

Error conditions 19 

Messages 20 
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Disk Print Program 14-16, 6, 8 

Control cards 15, 6 
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Messages 15-16 

Size of 14 

Disk-surface type of File Save operation 21 

dump card (Tape, Disk, Storage Print) ... .6, 8, 10, 13, 15, 19 

end card ( Data File Generator ) 30 

Entry to Unusual End of Program ( uep ) 12 

eof card (Data File Generator) 30 

eor card ( Data File Generator ) 30 

Erroneous records, bypassing of 27 

Error conditions, Format/Address Generators 19 
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fgn card (Data File Generator) 26-27, 25 
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Control cards 23 
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Messages 24 
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Control cards 21, 22 

Messages 22 
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Form C disk files 21, 23 
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Header label formats, Data File Generator 26 
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( see "Disk Format/Address Generator programs" ) . . 17-20, 6 

Indicators, status 8, 9, 10, 11, 12 

Input data cards ( Data File Generator ) 6, 25 

Instruction address register 9, 11, 12 

Interruption of print programs by operator 8 

ir (for next instruction) 9 

Labels, processing of, by Data File Generator 26 

last entry (Storage Print) 10 

lbl control card ( Data File Generator ) 28, 26 

Listings 8, 9, 10, 11, 14, 16 

Disk Print 16 

Snapshot 8, 9, 10 
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Tape Print 14 

Load card 21, 23 
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Move mode 13, 15, 18,' 26 

Multifile reels (Data File Generator) 26 

Multireel files (Data File Generator) 26 
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Generators ) 17 18 

nstd entry ( Format/Address Generators ) 17, 18 

Padding character ( Format/Address Generators ) 18 

Parameter-specification control-card errors 6 

Parity 8, 25 

Partial printout ( Storage Print ) 12 

pow (Peripheral Output Writer) program 8 
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